fiware/cloud-portal repository overview

⁠How to use this Dockerfile

To run a Cloud Portal Docker container you have two options:

• You can build your own image using the Dockerfile we provide and then run the container from it or
• you can run the container directly from the image we provide in Docker Hub.

Both options require that you have docker⁠ installed on your machine.

⁠Build your own image and run the container from it

You have to download the Cloud Portal's code⁠ from GitHub and navigate to extras/docker directory. There, to compile your own image just run:

sudo docker build -t cloud-portal-image .

This builds a new Docker image following the steps in Dockerfile and saves it in your local Docker repository with the name cloud-portal-image. You can check the available images in your local repository using:

sudo docker images

Now you can run a new container from the image you have just created with:

sudo docker run -d --name cloud-portal-container -v [host_config_file]:/opt/fiware-cloud-portal/config.js -p [host_port]:[container_port] cloud-portal-image

Where the different params mean:

• -d indicates that the container runs as a daemon
• --name is the name of the new container (you can use the name you want)
• -v stablishes a relation between a local folder (in your host computer) and a container's folder. In this case it is used to pass to the container the configuration file that Cloud Portal needs to work. host_config_file has to be the location of a local file with that configuration following the config template⁠.
• -p stablishes a relation between a local port and a container's port. You can use the port you want in host_port but container_port has to be the same that you have set in config.app_port in your config file. If you have set config.https to true you have to use here the https port.
• the last param is the name of the image

Here is an example of this command:

sudo docker run -d --name cloud-portal -v /home/root/workspace/fiware-cloud-portal/config.js:/opt/fiware-cloud-portal/config.js -p 80:80 cloud-portal-image

Once the container is running you can view the console logs using:

sudo docker logs -f cloud-portal

To stop the container:

sudo docker stop cloud-portal

⁠Run the container from the last release in Docker Hub

You can also run the container from the image we provide⁠ in Docker Hub. In this case you have only to execute the run command. But now the image name is ging/cloud-portal:version where version is the release you want to use:

sudo docker run -d --name cloud-portal-container -v [host_config_file]:/opt/fiware-cloud-portal/config.js -p [host_port]:[container_port] ging/cloud-portal