Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 13 additions & 16 deletions docs/guide/deployment-with-argo.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,27 @@
# Déploiement de votre application

Une fois qu'un dépôt d'infrastructure est synchronisé, il convient de se rendre sur le service ArgoCD depuis la liste des services :
![argocd](/img/tuto/4argocd.png)
Lors de la configuration du dépôt d'infrastructure, depuis la console, il est possible de choisir quelques spécificités et notamment :

Cliquez sur l'application nouvellement créé afin de finaliser sa configuration :
- **Nom de la révision** : correspond à la branche (ou tag) du dépôt d'infra à déployer, par défaut la cible sera HEAD.
- **Chemin du répertoire** : correspond au chemin vers vos fichiers de déploiement de type manifests, kustomize ou helm. La valeur par défaut est `.`, soit la racine du dépôt.
- **Fichiers values** : une liste des fichiers values à utiliser (dans le cas d'un Helm Chart). Si le pattern `<env>` est spécifié dans le chemin ou le nom du fichier, celui-ci sera remplacé par le **nom de l'environnement** lors du déploiement.

Allez dans le menu en haut et cliquez sur details :
![ArgoCD-menus](/img/tuto/4argocd-menus-bouton.png)

Sur l'écran qui s'affiche, cliquez sur le bouton *EDIT* et adaptez les valeurs renseignées par défaut par la console.
![ArgoCD-app-details](/img/tuto/4argocd-app-details.png)

Notamment :
![Options de déploiement](/img/tuto/options-repo-infra.png)

- **CLUSTER** : correspond au cluster sur lequel l'application doit être déployée, celà dépends des informations renseignées lors de l'étape de [gérer les environnements](/guide/environments-management).
- **TARGET REVISION** : correspond à la branche du dépôt d'infra à déployer, par défaut il point sur HEAD (master).
- **PATH** qui est positionné sur "helm/" par défaut. Vous devez indiquer le bon chemin vers vos fichiers de déploiement de type manifests, kustomize ou helm.
- Dans l'onglet **PARAMETERS**, il est possible de surcharger certaines valeurs du fichier values (mais il est préférable de modifier le fichier values directement)
> Attention, sur les versions précédentes de la console CPiN, ces modifications s'effectuaient depuis ArgoCD dans le menu details de l'application. Il est maintenant *obligatoire* de faire ces modifications depuis la console. En effet, toute modification depuis l'interface ArgoCD sur ces éléments ne sera pas pris en compte.

Finir la saisie en cliquant sur le bouton *SAVE*
## Visualisation dans ArgoCD

Le déploiement se fait automatiquement par ArgoCD, mais il est possible de forcer la synchronisation avec le dépôt sur gitlab Cloud π Native en cliquant sur les boutons:
Le déploiement se fait automatiquement par ArgoCD. Une fois qu'un dépôt d'infrastructure est synchronisé, il convient de se rendre sur le service ArgoCD depuis la liste des services.
Il est possible de forcer la synchronisation avec le dépôt sur gitlab Cloud π Native en cliquant sur les boutons :

- *REFRESH* pour forcer la synchronisation depuis le dépôt gitlab de la plateforme Cloud π Native
- *SYNC* pour forcer le rafraichissement entre l'état défini par git et l'état réel des objets créés par ArgoCD.

![ArgoCD-menus](/img/tuto/4argocd-menus-bouton.png)

Note : Si vous avez désactivé la synchronisation automatique, il faudra obligatoirement passer par cette synchronisation manuelle *SYNC*. Voir [Gestion des environnements](/guide/environments-management#synchronisation-argocd).

Une fois que le déploiement est correctement effectué le status de l'application ArgoCD doit correspondre à :

![ArgoCD-menus](/img/tuto/4argocd-menus.png)
11 changes: 9 additions & 2 deletions docs/guide/environments-management.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ pour chaque environnement, la console crée automatiquement :

Depuis la console, aller dans l'onglet *Configuration* d'un projet afin de configurer les quotas du projet. Ces quotas doivent correspondre à la demande d'hébergement validée par le ministère de l'intérieur.

A l'image de la demande d'hébergement, les quotas sont répartis en **ressources hors production** et **ressources production**. Sur chacun, il est nécessaire d'ajouter les limites en terme de CPU, RAM et GPU.
À l'image de la demande d'hébergement, les quotas sont répartis en **ressources hors production** et **ressources production**. Sur chacun, il est nécessaire d'ajouter les limites en terme de CPU, RAM et GPU.

![type](/img/environnement/quotas-projet.png)

Expand All @@ -36,4 +36,11 @@ Cliquez sur le bouton **+ Ajouter un nouvel environnement** puis compléter :
> Les quotas associés à un environnement correspondent à la somme des valeurs définies dans "resources.limits" de l'ensemble des pods déployés sur le namespace de son projet.

Une fois l'environnement créé, il est possible de voir la consommation total des environnements par rapport aux quotas du projet depuis l'onglet resources du projet.
![quota](/img/environnement/environnement-quota.png)
![quota](/img/environnement/environnement-quota.png)

## Synchronisation ArgoCD

Une Application ArgoCD est créé pour chaque Environnement déclaré dans la Console (et pour chaque Dépôt de type *infra*, voir [Déploiement](/guide/deployment-with-argo)).
Par défaut, ArgoCD synchronise automatiquement cette Application et les modifications pilotées par la Console. Toutefois si des spécificités ou des tests temporaires sont nécessaires, il est possible de désactiver cette synchronisation au niveau du paramétrage de l'Environnement.

![Désactivation de la synchronisation automatique](/img/environnement/env-autosync.png)
Binary file added docs/public/img/environnement/env-autosync.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/public/img/tuto/options-repo-infra.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.