Créer un workspace

Ce tutoriel vous guidera à travers les étapes pour créer votre premier workspace dans la plateforme Atlas.

Prérequis

• Avoir un compte sur la plateforme Atlas
• Être administrateur d'organisation ou avoir les droits nécessaires pour créer un workspace
• Avoir accès au dépôt GitOps de votre organisation

Qu'est-ce qu'un workspace ?

Un workspace est un conteneur pour un projet logiciel, avec son propre contrôle d'accès et des ressources spécifiques. Il correspond généralement à un projet qui a besoin de différentes ressources et environnements.

Étapes pour créer un workspace

1. Cloner le dépôt GitOps de votre organisation

1
2

git clone <URL du dépôt de votre organisation>
cd <nom du dépôt>

2. Créer un fichier YAML pour le workspace

Créez un nouveau fichier YAML dans le dossier resources du dépôt. Nommez-le de manière significative, par exemple mon-projet-workspace.yaml.

1
2

mkdir -p resources
touch resources/mon-projet-workspace.yaml

3. Définir la configuration du workspace

Ouvrez le fichier mon-projet-workspace.yaml dans votre éditeur préféré et ajoutez la configuration suivante :

1
2
3
4
5
6
7

apiVersion: organization.fabrique.social.gouv.fr/v1alpha1
kind: Workspace
metadata:
  name: mon-projet-workspace
spec:
  parameters:
    name: "mon-projet-workspace"

Assurez-vous de remplacer mon-projet-workspace par un nom significatif pour votre projet.

4. Pousser les changements vers le dépôt

1
2
3

git add resources/mon-projet-workspace.yaml
git commit -m "Ajout du workspace pour mon-projet"
git push

5. Vérifier la création du workspace

Une fois les changements poussés, ArgoCD détectera automatiquement les modifications et créera le workspace. Vous pouvez vérifier l'état de la création dans ArgoCD.

1. Accédez à ArgoCD via l'interface Atlas
2. Recherchez l'application correspondant à votre organisation
3. Vérifiez que le workspace a été créé avec succès

6. Accéder au dépôt du workspace

Une fois le workspace créé, un nouveau dépôt Git sera créé pour ce workspace. Vous pouvez trouver l'URL de ce dépôt dans le statut du workspace :

1. Dans ArgoCD, cliquez sur le workspace que vous venez de créer
2. Dans l'onglet "Status", vous trouverez l'URL du dépôt Git du workspace

Que faire ensuite ?

Maintenant que vous avez créé votre workspace, vous pouvez :

• Déployer votre première application
• Configurer une base de données
• Utiliser un bucket S3

Résolution des problèmes courants

Le workspace n'apparaît pas dans ArgoCD

• Vérifiez que vous avez bien poussé les changements vers le dépôt
• Vérifiez que le fichier YAML est correctement formaté
• Vérifiez que vous avez les droits nécessaires pour créer un workspace

Erreur lors de la création du workspace

• Vérifiez les logs dans ArgoCD pour identifier l'erreur
• Assurez-vous que le nom du workspace est unique
• Contactez l'administrateur de la plateforme si le problème persiste