Installation
Orbit tourne dans un conteneur Docker à côté d'une base PostgreSQL. Comptez dix minutes, reverse proxy et fournisseur OIDC déjà en place.
Orbit n'embarque ni reverse proxy, ni fournisseur d'identité, ni GitLab : il s'intègre à ceux que vous avez déjà (Traefik, Keycloak, GitLab).
Prérequis
- Docker 24+ ou Podman avec
docker compose - Un fournisseur OpenID Connect (Keycloak recommandé) et un client
orbit - Un jeton d'application GitLab avec le scope
api
Démarrer avec Docker Compose
Clonez le dépôt, copiez le fichier d'exemple, renseignez les variables puis lancez les conteneurs :
bash
git clone https://gitlab.com/masterit-infra/mit-orbit.git && cd mit-orbit
cp .env.example .env # puis éditez .env
docker compose up -d
docker compose exec app bin/console doctrine:migrations:migrateOrbit répond sur http://localhost:8080. Ouvrez la recherche à tout moment avec /.
Variables d'environnement
| Variable | Défaut | Rôle |
|---|---|---|
DATABASE_URL | — | Connexion PostgreSQL, ex. postgresql://orbit:…@db:5432/orbit. |
APP_SECRET | — | Clé de chiffrement des sessions. Générez-la : openssl rand -hex 32. |
DEFAULT_URI | http://localhost:8080 | URL publique d'Orbit, utilisée dans les liens et les redirections OIDC. |
OIDC_ISSUER | — | URL du realm de votre fournisseur OpenID Connect (Keycloak…). |
OIDC_CLIENT_ID | orbit | Identifiant du client OIDC. |
GITLAB_URL | https://gitlab.com | Instance GitLab dont Orbit lit les issues. |
Ne commitez jamais .env. APP_SECRET et le mot de passe de la base
vont dans votre coffre de secrets ; seul .env.example, sans valeur, est versionné.
Vérifier l'installation
- Connectez-vous : vous êtes redirigé vers votre fournisseur OIDC, puis vers Orbit.
- Créez un espace de travail, puis un projet.
- Reliez un dépôt GitLab : ses issues apparaissent comme tâches en quelques secondes.
Tout fonctionne ? Passez à Premier projet.