Skip to content

Latest commit

 

History

History
82 lines (45 loc) · 3.1 KB

DEPLOY.rst

File metadata and controls

82 lines (45 loc) · 3.1 KB
Raw

Deploying

The docker-compose.yml in the root of the source tree can be used to run cube-builder as a multi-container application.

This section explains how to get the cube-builder service up and running with Docker and Docker Compose. If you do not have Docker installed, take a look at this tutorial on how to install it in your system. See also the tutorial on how to install Docker Compose.

Configuration

docker-compose.yml

Open and edit docker-compose.yml with the following variables:

  1. DATA_DIR - Path to store collections.
  2. SQLALCHEMY_DATABASE_URI - Database URI.
  3. RABBIT_MQ_URL - URI to connect on RabbitMQ protocol.

Running the Docker Containers

Note

If you do not have a PostgreSQL instance with the Brazil Data Cube data model up and running, you will need to prepare one before following the rest of this documentation.

In order to launch a PostgreSQL container, you can rely on the docker-compose service file. The following command will start a new container with PostgreSQL:

$ docker-compose up -d postgres

After launching the container, please, refer to the section "Prepare the Database System" in the INSTALL.rst documentation. This will guide you in the preparation of the PostgreSQL setup.

Use the following command in order to launch all the containers needed to run cube-builder [1]:

$ docker-compose up -d

If the above command runs successfully, you will be able to list the launched containers:

$ docker container ls

CONTAINER ID        IMAGE                                                    COMMAND                  CREATED             STATUS              PORTS                    NAMES
a3bb86d2df56        rabbitmq:3-management                                    "docker-entrypoint.s…"   3 minutes ago       Up 2 minutes        4369/tcp, 5671/tcp, 0.0.0.0:5672->5672/tcp, 15671/tcp, 25672/tcp, 0.0.0.0:15672->15672/tcp   cube-builder-rabbitmq
e3862ab6e756        registry.dpi.inpe.br/brazildatacube/cube-builder:latest  "bash -c 'cube-build…"   2 minutes ago       Up 2 minutes        0.0.0.0:5001->5000/tcp   cube-builder-api
13caa0f27030        registry.dpi.inpe.br/brazildatacube/cube-builder:latest  "cube-builder worker…"   2 minutes ago       Up 2 minutes                                 cube-builder-worker

Note

Refer to the USING.rst documentation in order to use the cube builder services.

Footnotes

[1]
For now you will need to login into the BDC registry:
$ docker login registry.dpi.inpe.br

In the next releases we will get ride of this internal registry.