Skip to content
This repository has been archived by the owner on Feb 13, 2023. It is now read-only.

Latest commit

 

History

History
318 lines (271 loc) · 12.3 KB

README.production-test.md

File metadata and controls

318 lines (271 loc) · 12.3 KB
Raw

Ergonode production docker testing on swarm installed on your localhost

Preparing the local environment for testing

Enable Swarm mode

  1. You Must enable swarm mode with command docker swarm init:

     $ docker swarm init
 Swarm initialized: current node (i4imqmykpz6a6o9amevr491v4) is now a manager.
 
 To add a worker to this swarm, run the following command:
 
     docker swarm join --token SWMTKN-1-5gw46owitfxgvgsbdb19a3cz0ox5ulu07tf7ga1zrto6ouuxrc-a2ulaio3v9rnqqbtxwff2tunj 192.168.99.200:2377
 
 To add a manager to this swarm, run 'docker swarm join-token manager' and follow the instructions.

    In some cases it will be necessary to execute command docker swarm init --advertise-addr <MANAGER-IP>

    More documentation about enabling swarm mode you can find in https://docs.docker.com/engine/swarm/swarm-mode/

Set up a Docker registry🔗

For testing you need setup local registry.

  1. Start the registry as a service on your swarm:

    $ docker service create --name registry --publish published=5000,target=5000 registry:2
5vfwyy0etx9pvb1tcns1qtrl8
overall progress: 1 out of 1 tasks 
1/1: running   [==================================================>] 
verify: Service converged

  2. Check its status with docker service ls:

    $ docker service ls
ID                  NAME                MODE                REPLICAS            IMAGE               PORTS
5vfwyy0etx9p        registry            replicated          1/1                 registry:2          *:5000->5000/tcp

  3. Check that it’s working with curl:

    $ curl http://localhost:5000/v2/

{}

Build your production code

  1. You Must copy or clone your production backend and frontend app to the docker directory.

  2. Directory structure

    docker/
├── frontend
├── backend

  3. Set your build environment variables. You can use for this the .env file.

    COMPOSE_PROJECT_NAME=ergonode
CONTAINER_REGISTRY_BASE=localhost:5000/ergonode

  4. Build with command

    docker-compose  -f docker-compose.deploy.yml  build

    or faster build with enabled BuildKit

    COMPOSE_DOCKER_CLI_BUILD=1 DOCKER_BUILDKIT=1 docker-compose  -f docker-compose.deploy.yml  build

Push images to local registry

  1. To push your images to your registry you need execute command.

    $ docker-compose  -f docker-compose.deploy.yml  push
Pushing php (localhost:5000/ergonode/php:latest)...
The push refers to repository [localhost:5000/ergonode/php]
9dcb7c3cba06: Pushed
317220a89f7a: Pushed
8869b7f8d14b: Pushed
0b5d19df65c0: Pushed
67aa39707573: Pushed
8f0e5fed38ca: Pushed
9868b4b7e471: Pushed
3e5a91435251: Pushed
de4d41a476fa: Pushed
cf44941de815: Pushed
bb9023598f8e: Pushed
80b84485e3db: Pushed
09910eb25821: Pushed
93bcee3daaff: Pushed
c1f1b3bb785a: Pushed
1769ec9d9fbb: Pushed
2be2bea30da4: Pushed
35c5254fa70a: Pushed
98075e80af84: Pushed
e02653067cbc: Pushed
6f376367414e: Pushed
546d72961a9b: Pushed
a284cca01749: Pushed
0f17bf26d50f: Pushed
a08a6a32d21a: Pushed
9ca12a39140e: Pushed
0078526f623d: Pushed
ba661e61e5ca: Pushed
ee40c7334a95: Pushed
beee9f30bc1f: Pushed
latest: digest: sha256:571240eceee46a9ddec431c3a05181e286382925948030585562d03c61b8e4ac size: 6593
Pushing nuxtjs (localhost:5000/ergonode/nuxtjs:latest)...
The push refers to repository [localhost:5000/ergonode/nuxtjs]
d4bf0d1f3bae: Pushed
5f70bf18a086: Pushed
4511ef4fad3d: Pushed
111e3208ee56: Pushed
fe5324d0691a: Pushed
f2569cae1768: Pushed
352920ec1073: Pushed
662f8f5a2b7a: Pushed
00210cd15c5c: Pushed
ffa1cdbe8bf7: Pushed
f1b5933fe4b5: Pushed
latest: digest: sha256:a624e2ff6f8fd1684a377a82c0e6258174684479f5da37fb2d6686997367bff0 size: 2827
Pushing nginx (localhost:5000/ergonode/nginx:latest)...
The push refers to repository [localhost:5000/ergonode/nginx]
15f7b07e2eb1: Pushed
c4a41daeabbf: Pushed
6a7bac1cc4a5: Pushed
0f91bfd1b7b4: Pushed
bc4f27e27c4c: Pushed
03e7b7ac5f4c: Pushed
ca38b6f1110c: Pushed
6f23cf4d16de: Pushed
531743b7098c: Pushed
latest: digest: sha256:96cb5a1245ac7792df763bebe1c261272a4b4e4c7f09d2fd5d066eef20899202 size: 2405
Pushing postgres (localhost:5000/ergonode/postgres:latest)...
The push refers to repository [localhost:5000/ergonode/postgres]
ad721fbf05ac: Pushed
20b113d053ff: Pushed
a283fe349755: Pushed
004c5c491659: Pushed
2084a1a5fdaa: Pushed
36589f5f7745: Pushed
554b8a481572: Pushed
ad31bd535054: Pushed
2d9f8a4bb985: Pushed
c1fe1c22cb47: Pushed
34ba88304670: Pushed
a55a08db54f9: Pushed
beee9f30bc1f: Mounted from ergonode/php
latest: digest: sha256:51d61dc5992c093fbb69a960376bc20b327fddf807b7876b56e6652c61c2198a size: 3020
Pushing haproxy (localhost:5000/ergonode/haproxy:latest)...
The push refers to repository [localhost:5000/ergonode/haproxy]
1dd6602aeaba: Pushed
1d7bfabed83a: Pushed
26ab55d789a8: Pushed
065b7480de97: Pushed
beee9f30bc1f: Mounted from ergonode/postgres
latest: digest: sha256:be0c4ef6d6ff88ae660f1e4def955fe70166bb9e57d224b1dda54a0d9cc5549d size: 1363
Pushing rabbitmq (localhost:5000/ergonode/rabbitmq:latest)...
The push refers to repository [localhost:5000/ergonode/rabbitmq]
84a43432a8f4: Pushed
14424cfa9842: Pushed
757705f5325b: Pushed
0929bd357320: Pushed
77a02e0abffa: Pushed
ef81076db681: Pushed
3a77603d9a2e: Pushed
55285c124aa2: Pushed
5f445fdd2cbe: Pushed
b533ec746365: Pushed
3af4411af099: Pushed
ea443b32be83: Pushed
beee9f30bc1f: Mounted from ergonode/haproxy
latest: digest: sha256:81e6b3204ac1688a2476b91227d4a9dad61f835b5794a59b38a2e950f735d5ce size: 3038

Deploy the stack to the swarm

  1. You need set all environment required variables described in docker-compose.production.yml and in docker-compose.postgres.yml.

  2. And also you need create secrets required in docker-compose.production.yml and in docker-compose.postgres.yml.

    For each secret please enter your secret and press CTRL+D

    $ docker secret create ergonode-postgres-passwd -    

    $ docker secret create ergonode-user-passwd -

  3. For environmental variables, you can create a file .env.

  4. Create the your stack with docker stack deploy:

     $ env $(cat .env | grep ^[a-zA-Z] | xargs) docker stack deploy --compose-file docker-compose.production.yml --compose-file docker-compose.postgres.yml  ergonode

 Creating network ergonode_ergonode
 Creating service ergonode_php-messenger-export
 Creating service ergonode_rabbitmq-02
 Creating service ergonode_php-messenger-core
 Creating service ergonode_php
 Creating service ergonode_nginx
 Creating service ergonode_php-messenger-import
 Creating service ergonode_postgres
 Creating service ergonode_rabbitmq-01
 Creating service ergonode_consul
 Creating service ergonode_nuxtjs
 Creating service ergonode_php-messenger-segment
 Creating service ergonode_rabbitmq-03
 Creating service ergonode_haproxy

  5. Check that it’s running with docker stack services ergonode:

    $ docker stack services ergonode
ID                  NAME                             MODE                REPLICAS            IMAGE                                     PORTS        
69uby4hcw9ar        ergonode_php-messenger-segment   replicated          1/1                 localhost:5000/ergonode/php:latest        
8qtlwf3u3wli        ergonode_rabbitmq-01             global              1/1                 localhost:5000/ergonode/rabbitmq:latest   
bvel8mli4ymd        ergonode_rabbitmq-03             global              1/1                 localhost:5000/ergonode/rabbitmq:latest   
cxtlqpulnjjl        ergonode_php-messenger-core      replicated          1/1                 localhost:5000/ergonode/php:latest        
g0daudkr5v3c        ergonode_php-messenger-export    replicated          1/1                 localhost:5000/ergonode/php:latest        
h9uc5g0kqffy        ergonode_postgres                global              1/1                 localhost:5000/ergonode/postgres:latest   
i0u876bxsyul        ergonode_nuxtjs                  replicated          1/1                 localhost:5000/ergonode/nuxtjs:latest     
jvz19jpgzzb9        ergonode_nginx                   replicated          1/1                 localhost:5000/ergonode/nginx:latest      *:80->80/tcp
ls2wvroa777r        ergonode_php-messenger-import    replicated          1/1                 localhost:5000/ergonode/php:latest        
n3ukz3z6tm30        ergonode_consul                  replicated          1/1                 consul:1.7                                
of4toxprxoaf        ergonode_rabbitmq-02             global              1/1                 localhost:5000/ergonode/rabbitmq:latest   
rlnxa9vsuedh        ergonode_php                     replicated          1/1                 localhost:5000/ergonode/php:latest        
skcutkkb5fza        ergonode_haproxy                 global              1/1                 localhost:5000/ergonode/haproxy:latest    *:15672->15672/tcp

    This might take some time if you have a multi-node swarm, as images need to be pulled. It may take some time if you have a multi-node, because the images have need to be pulled by swarm nodes.

    And you can test your application on port 80 (by default this is set in environment variable $EXPOSED_NGINX_PORT) at http://your-swarm-node-ip.

  6. To check your service logs you can do this with docker service logs ergonode_service_name

    $ docker   service logs -f ergonode_nginx
ergonode_nginx.1.z8ohiml3lj9l@swarm    | 127.0.0.1 - - [25/Feb/2020:09:59:49 +0000] "GET /api/doc HTTP/1.1" 200 98347 "-" "curl/7.66.0" "-"

  7. To troubleshoot why some services does not up . You can find your service container with command:

    $ docker ps

    This example display container id for php service

    $ docker ps  -f name=ergonode_php.1
CONTAINER ID        IMAGE                                COMMAND                  CREATED             STATUS                    PORTS               NAMES
a81d054a6473        localhost:5000/ergonode/php:latest   "docker-entrypoint p…"   10 minutes ago      Up 10 minutes (healthy)   9000/tcp            ergonode_php.1.fd63lm163x7wudnob7xrju91h

    And to display logs you can execute

    $ docker logs a81d054a6473
Linking /usr/local/etc/php/php.ini-production > /usr/local/etc/php/php.ini
Verified OK
Setting file permissions...
Waiting for db to be ready...
                                                                    
                    Doctrine Database Migrations                    
                                                                    

No migrations to execute.
app initialization finished
[01-Apr-2020 18:30:05] NOTICE: fpm is running, pid 1
[01-Apr-2020 18:30:05] NOTICE: ready to handle connections

  8. If you want to bring down your stack then you can execute docker stack rm:

    $ docker stack rm ergonode 

Removing service ergonode_consul
Removing service ergonode_haproxy
Removing service ergonode_nginx
Removing service ergonode_nuxtjs
Removing service ergonode_php
Removing service ergonode_php-messenger-core
Removing service ergonode_php-messenger-export
Removing service ergonode_php-messenger-import
Removing service ergonode_php-messenger-segment
Removing service ergonode_postgres
Removing service ergonode_rabbitmq-01
Removing service ergonode_rabbitmq-02
Removing service ergonode_rabbitmq-03
Removing network ergonode_ergonode

    And you can optionally prune ergonode volumes

    $ docker volume prune --filter label=com.docker.stack.namespace=ergonode
WARNING! This will remove all local volumes not used by at least one container.
Are you sure you want to continue? [y/N] y
Deleted Volumes:
ergonode_multimedia
ergonode_avatar
ergonode_import
ergonode_jwt
ergonode_ergonode-postgres-data
ergonode_rabbitmq-01
ergonode_rabbitmq-02
ergonode_rabbitmq-03

Total reclaimed space: 1.086GB