Premiers pas

Installation

Installer ARCHWAY est trés facile, l'application ARCHWAY nécessite 2 images docker. L'image de ARCHWAY et l'image de mongodb.

tip

Notez que la base de données mongodb peut être clusterisée (dans swarm ou k8s), mais surtout peut être utilisée par vos microservices pour stocker vos documents.

warning

En revanche il est déconseillé d'accéder et surtout de modifier les documents de ARCHWAY via vos services internes. C'est ce que l'on appelle la gouvernance de la donnée.

La meilleur facon d'installer ARCHWAY est de le déployer au sein d'un cluster. Mais vous pouvez bien sur l'installer comme simple container docker via docker-compose.

Fichier docker-compose.yml

docker-compose.yml

docker-compose.yml

version: '3.8'
services:
  archway:
    image: ghcr.io/softwarity/archway-ce:latest
    ports:
      - 8080:8080 # non HTTPS
    environment:
      MONGODB_HOST: mongodb 
      MONGODB_DB_NAME: archway
      MONGODB_USER: admin
      MONGODB_PWD: changeit
    networks:
      - net

  mongodb:
    image: mongo # official image  
    environment:
      MONGO_INITDB_DATABASE: archway
      MONGO_INITDB_ROOT_USERNAME: admin
      MONGO_INITDB_ROOT_PASSWORD: changeit
    volumes:
      - mongodb_data:/data/db
    networks:
      - net

volumes:
  mongodb_data:

networks:
  net:

tip

Notez que le volume mongodb_data n'a pas de destination précisée et sera donc géré par docker. Voir volume pour plus de détails.

tip

Notez qu'en absence de certificat, le HTTPs n'est pas actif par defaut.
Voir Activer le HTTPS

docker-compose

docker compose -f docker-compose.yml pull
docker compose -f docker-compose.yml up -d

cluster Swarm

Dans cette exemple, nous allons lancer ARCHWAY dans une stack myapp.

docker stack deploy -c docker-compose.yml myapp

cluster Kubernetes

Pour déployer ARCHWAY dans un cluster kube, il convient d'utiliser d'autre fichiers de déploiement.

Configuration

Par l'interface

Par fichiers json