Introduction

At some point in our life, we may need almost everything in a private scope, and the same happens with your NPM packages as well. You have created a private NPM package for your company or for yourself and you wanted to host it somewhere, you might have already looked for some options like a paid version of npmjs and many more. But, you were not happy doing it, and somehow you have reached in this article, and I am sure you are expecting something with Docker here. Yes, we are actually going to change our Docker container instance to a private NPM registry, and once it is ready you can always host your private npm packages to that registry. If you are not sure of how to create an npm package, please read my Sounds cool? Then, let’s jump into it. I hope you will find this post useful.

Background

As I mentioned before, I am going to create a Container Instance and will be changing it to a private NPM registry. I will be using Microsoft Azure, if you don’t have a valid Azure subscription, I strongly recommend you to create one.

Setting up a Docker Private NPM Registry

Once you get the Azure subscription, you can start the setups.

Creating Azure Container Registry

Do you have a GitHub account? Do you know what we can do with a Github account? Yes, we can upload our projects/source codes there and we can do versioning, we can create branches and many more. You can consider that the Azure Container Registry is a similar service to that. An Azure Container Registry or ACR is a private Docker registry where you can easily manage all of your Docker container images in the same place. Isn’t that cool? According to Microsoft, you can use Azure Container Registry to:

• Store and manage container images across all types of Azure deployments
• Use familiar, open-source Docker command line interface (CLI) tools
• Keep container images near deployments to reduce latency and costs
• Simplify registry access management with Azure Active Directory
• Maintain Windows and Linux container images in a single Docker registry

To create the Azure Container Registry, you should have a valid Azure subscription. If you don’t have one, please get one, that will help you follow this article.

Once you logged in to the Portal. You can click on the + icon, Create a resource, and search for the Container Registry.

Search Container Registry

When you click the Container Registry, you will be asked to give the details as shown in the preceding image.

Container Registry Details

Please remember to enable the Admin user, as you will be able to use the registry name as username and admin user access key as the password to docker login to your container registry only if it is enabled. I will explain the same in the coming section.

Once you create your Container Registry, you will be given a login server as yourregistryname.azurecr.io. You can always see other information in the overview section. If you click on the Access Keys link under the settings, you can see the username and the password for your Container Registry. Remember we have enabled the Admin User property while creating the Container Registry?

Container Registry Settings

Creating a Docker Container in Local

Docker version

docker pull verdaccio/verdaccio

verdaccio/verdaccio           latest              c542d9e516e4        3 weeks ago         659MB

It may take a few minutes to pull the entire image. As I have already pulled the latest image, it will be quick for me and get the output as below.

Docker pull verdaccio

You can also tag the version you need, just in case.

docker pull verdaccio/verdaccio:3

Now it is time to run the Verdaccio, are you ready?

docker run -it --rm --name verdaccio -p 4873:4873 verdaccio/verdaccio

The last argument is our image name, if you don’t have such an image in your local, the same will be pulled from the Docker hub. As you might have noticed already we are using the port 4873, and the same will be mapped to the container instance port later when we create the container instance. Now please make sure that you are getting an output as preceding.

Verdaccio docker run

You should now be able to go into http://localhost:4873 and see that verdaccio is running successfully.

Pushing Local Container to Azure Container Registry

Now that we have an Azure Container Registry running and a local container which can act as a private NPM registry. What are we waiting for? Let’s just push this to our ACR. Before that, we need to login to our Azure Container Registry server.

docker login sibeeshpassion.azurecr.io

Once you run the above command with the correct credential, you will be able to see the output as below.

Docker login Azure container registry

Now let’s just tag our image, as this will help to manage our images easily in the Container Registry.

docker tag <image name> <login server>/<repository name>/<name>:v1

For example, I used this command as below.

docker tag verdaccio/verdaccio sibeeshpassion.azurecr.io/verdaccio/verdaccio:v1

Let’s push our image to the Container Registry now.

docker push sibeeshpassion.azurecr.io/verdaccio/verdaccio:v1

If everything goes well, you must see an output as preceding.

Pushing to Container Registry

Now, you can log in to your Azure portal and check the repositories of your Azure Container Registry. You should be able to see your image with the tag we have provided.

Repository in Azure Container Registry

Creating a Container Instance

Now, we have a valid Container Registry which can act as a private NPM registry and is that enough? N,o it is not, we are not finished yet. We need a place where this registry can run. Well, Azure has everything we need, we are going to create a Container Instance for this purpose. A container instance is a simplest and fastest way to run a single container. While creating the Container Instance, you will have to go through 3 steps.

1. Configure the basic settings
2. Specify container requirements
3. Container instance

Configure Basic Settings

You can configure the settings as per your needs, I have configured mine as below.

Container Instance Basic Settings

Please be noted that I have given the container image type as Private.

Specify Container Requirements

Here in this step, I am going to select the Public IP address as “Yes”, so that I can set the DNS label while configuring. And I will also set the port as 4873.

Network Settings in Azure Container Instance

Container Instance

In this step, you can verify all of your settings, and in the background, Azure will validate the settings and if it is valid, the OK button will be enabled, click OK once it is enabled. It may take some time to build your resource and once it is done you can always go to the overview of your Container Instance and run it with the port 4873. For example, I can see my container in this URL http://sibeeshpassion.westeurope.azurecontainer.io:4873/#/.

Pushing Your Own Private NPM Package to Docker Private NPM Registry

Wow!, we have a private Docker NPM registry now. Let’s just try to push our private NPM package to this registry now. I have created my own NPM package a few days back, if you want to know how, you can always read this article: Create Your Own NPM Package — Private or Public. I will open my package in the vscode.

Let’s add the user before we publish the package.

npm adduser --registry=http://sibeeshpassion.westeurope.azurecontainer.io:4873/#/

The above command will ask you for the username and password.

NPM Publish with Private Registry AddUser

Now we can run our publish command.

npm publish dist --registry=http://sibeeshpassion.westeurope.azurecontainer.io:4873/#/

You can get an output as preceding if the publishing is successful.

npm notice === Tarball Details ===
npm notice name:          org-npm-package
npm notice version:       1.1.1
npm notice package size:  7.8 kB
npm notice unpacked size: 37.9 kB
npm notice shasum:        f1d8e033bb6d2545502802510258cf9f8bcc9ab3
npm notice integrity:     sha512-3MuplP75D0gpj[...]Z5KFo0DNbzGFw==
npm notice total files:   22
npm notice
+ org-npm-package@1.1.1

What are you waiting for, just go and see your package in your Docker, I was eagerly waiting for this moment, and I am going to see my package by hitting my container here http://sibeeshpassion.westeurope.azurecontainer.io:4873/#/detail/org-npm-package.

Using Your Private Package from the Docker Private NPM Registry

Just run the below command and your private package will be pulled from your private Docker NPM registry.

npm install org-npm-package --registry=http://sibeeshpassion.westeurope.azurecontainer.io:4873

Conclusion

Congratulation, we have successfully created a Docker Private NPM Registry, go ahead and create as many private packages you wish and move those to your Private NPM registry. Thanks a lot for following/reading this article. I really appreciate your time and effort.  In this article, we have learned how to,

1. Create an Azure Container Registry
2. Create a Local Docker Container
3. Create Verdaccio image and run it in a local docker container
4. Push the local Verdaccio image to the Azure Container Registry
5. Set up the Docker Container Instance using the Azure Container Registry
6. Pushing the NPM package to the Private Docker NPM registry
7. Pulling the package from the Private registry

Your turn. What do you think?

Thanks a lot for reading. I will come back with another post on the same topic very soon. Did I miss anything that you may think which is needed? Could you find this post as useful? Kindly do not forget to share me your feedback.

Kindest Regards
Sibeesh Venu

Introduction

Here, in this post we are going to a see how we can install Asp.Net Core Docker in our Windows. Before we start, it would be useful if we say something about the Docker right? Docker is a container software platform where container is everything we need to make our software run. The container is light in weight. You can read more about the Docker here. I hope you will like this. Now let’s begin.

Background

Today, I was just trying to create a Asp.Net Docker application in Visual Studio 2017. Unfortunately I was getting an error as preceding.

Error MSB4018 The “PrepareForBuild” task failed unexpectedly.
Microsoft.DotNet.Docker.CommandLineClientException: Unable to run ‘docker-compose’. Verify that Docker for Windows is installed and running locally. For troubleshooting, please review http://aka.ms/DockerToolsTroubleshooting. —> System.ComponentModel.Win32Exception: The system cannot find the file specified

Then I came to know that I have not installed Docker in my machine yet, so I decided to do that.

Asp Net Core Docker Error

Installing Docker For Windows

You can install the Docker from here. Once you downloaded the set up file, please run the file.

Docker For Windows

Start and test the Docker

Once you installed the Docker, now it is time to test whether everything is installed correctly or not. Before that make sure that the Docker is starting.

Docker is Starting

There is a hight possibility that to get an error “Hardware assisted virtulization and data execution protection must be enabled in the BIOS” as preceding image.

Docker Error

Before you go and change the settings in BIOS, check in Task Manager window as well.

Hyper V support and Virtulization

Enabling Virtulization in BIOS

To Enable the Virtulization in BIOS, go to System Configuration -> Click on Virtulization Technology and Enable it.

BIOS Settings

After the restart, the Docker will ask you to start the service. Go ahead and do that.

Setting up Docker

Docker Service Is Not Runnig Window

Now again, if you are getting an error as “Error MSB4018 The “PrepareForLaunch” task failed unexpectedly.
Microsoft.DotNet.Docker.CommandLineClientException: Creating network “dockercompose3875147227_default” with the default driver
Building linq_basic_to_advanced Service ‘linq_basic_to_advanced’ failed to build: Get https://registry-1.docker.io/v2/: net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers).”, you need to change your shared drive settings in Docker.

Right click and click on the settings.

Docker Settings

Click on the Shared Drives and  select the drive that hosts your project and the drive where %USERPROFILE% resides.

Shared Drive in Docker

Click on Apply and type your filesystem passwor in the following pop up. Now if you are running the Edge version of Docker Community Edition for Windows, after the install you may be able to login with your Docker ID and password.

Docker SignIn page

We have enough settings for now, shall we just check whether the installation is done perfectly or not? To check, go to the command window and type the command as  docker run hello-world.

Docker Check From Command Window

You can also check the Docker version with the command docker –version

Conclusion

Did I miss anything that you may think which is needed? Could you find this post as useful? I hope you liked this article. Please share me your valuable suggestions and feedback.

Your turn. What do you think?

A blog isn’t a blog without comments, but do try to stay on topic. If you have a question unrelated to this post, you’re better off posting it on C# Corner, Code Project, Stack Overflow, Asp.Net Forum instead of commenting here. Tweet or email me a link to your question there and I’ll definitely try to help if I can.

Kindest Regards
Sibeesh Venu