Aller au contenu principal

Installer Astrolabe

Il y a deux façons d'avoir Astrolabe. Choisis-en une, puis configure-le.

SaaSOn-prem
Qui le fait tournerForgeIT l'héberge pour toiTu le fais tourner dans ton infrastructure
Ce que tu reçoisUne adresse et un compte administrateurL'image d'Astrolabe et les fichiers ci-dessous
Tes donnéesHébergées par ForgeITRestent dans ton PostgreSQL

☁️ SaaS : on l'héberge pour toi​

  1. Demande ton instance sur le site de ForgeIT : www.forgeit.fr.

  2. Tu reçois l'adresse de ton Astrolabe, l'identifiant et le mot de passe de l'administrateur.

✅ C'est fait ! Passe à Configurer Astrolabe.

🏢 On-prem : dans ton infrastructure​

Il te faut Docker démarré sur la machine, avec 8 Go de mémoire donnés à Docker, et le nom de l'image d'Astrolabe, que ForgeIT te donne avec ta licence. Voir Nous contacter.

  1. Crée un dossier vide et enregistre-y ce fichier sous le nom docker-compose.hub.yml.

    name: astrolabe-hub

    services:
      postgres:
        image: postgres:14-alpine
        command: postgres -c max_connections=300
        environment:
          POSTGRES_USER: ${POSTGRES_USER:-backstage}
          POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-backstage}
        volumes:
          - astrolabe-postgres:/var/lib/postgresql/data
        healthcheck:
          test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-backstage}"]
          interval: 5s
          timeout: 5s
          retries: 10

      astrolabe:
        image: ${ASTROLABE_IMAGE:?set ASTROLABE_IMAGE}
        container_name: astrolabe-hub
        depends_on:
          postgres:
            condition: service_healthy
        ports:
          - "${ASTROLABE_PORT:-7007}:7007"
        environment:
          ENVIRONMENT: production
          FRONTEND_BASE_URL: http://127.0.0.1:${ASTROLABE_PORT:-7007}
          BACKEND_BASE_URL: http://127.0.0.1:${ASTROLABE_PORT:-7007}
          POSTGRES_HOST: postgres
          POSTGRES_PORT: 5432
          POSTGRES_USER: ${POSTGRES_USER:-backstage}
          POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-backstage}
          ADMIN_USERNAME: ${ADMIN_USERNAME:-administrator}
          ADMIN_EMAIL: ${ADMIN_EMAIL:-admin@astrolabe.local}
          ADMIN_PASSWORD: ${ADMIN_PASSWORD:-astrolabe}
          BACKEND_SECRET: ${BACKEND_SECRET:-local-only-change-me-before-sharing}
          ORGANIZATION_NAME: ${ORGANIZATION_NAME:-Astrolabe}

    volumes:
      astrolabe-postgres:

  2. Dans un terminal ouvert dans ce dossier, donne le nom de l'image et démarre Astrolabe. Remplace la valeur par le nom que tu as reçu.

    export ASTROLABE_IMAGE=<le nom d'image que tu as reçu>
    docker compose -f docker-compose.hub.yml up -d

    Le premier démarrage télécharge l'image, puis prépare la base : compte deux à trois minutes.

  3. Ouvre http://127.0.0.1:7007. Utilise cette adresse, pas localhost : la connexion compare l'adresse que tu ouvres à celle du fichier.

  4. Connecte-toi avec l'identifiant administrator et le mot de passe astrolabe.

  5. Avant de partager cet Astrolabe, change le mot de passe et le secret. Mets-les dans un fichier .env à côté de docker-compose.hub.yml, puis redémarre avec la même commande qu'à l'étape 2.

    ADMIN_PASSWORD=<un mot de passe que toi seul connais>
    BACKEND_SECRET=<un long texte aléatoire>
    astuce

    Choisis BACKEND_SECRET avant de configurer quoi que ce soit. Il chiffre les secrets saisis dans l'Administration : le changer ensuite les rend illisibles.

✅ C'est fait ! Passe à Configurer Astrolabe.

Pour arrêter Astrolabe, lance docker compose -f docker-compose.hub.yml down. Tes données restent. Pour le redémarrer, lance la commande de l'étape 2.

🧪 L'essayer en une commande​

Pour jeter un œil avant de décider, démarre une démo sur des données d'exemple, sans PostgreSQL :

docker run --rm -p 7007:7007 --tmpfs /run/astrolabe-db -e DEMO_MODE=true -e ASTROLABE_DEMO_OPEN=true "$ASTROLABE_IMAGE"

Ouvre http://localhost:7007 et clique sur Démarrer en tant qu'invité. La démo est en lecture seule et tout disparaît quand tu arrêtes le conteneur.

La démo publique de ForgeIT fonctionne autrement : tu demandes d'abord l'accès. Voir Demander l'accès à la démo.

📞 Nous contacter​

➡️ La suite​

Configurer Astrolabe : connexion, licence, outils et catalogue.