diff --git a/docs/.vitepress/sidebar.json b/docs/.vitepress/sidebar.json index 779ce7a..2b71f50 100644 --- a/docs/.vitepress/sidebar.json +++ b/docs/.vitepress/sidebar.json @@ -260,10 +260,6 @@ "text": "Clusters", "link": "/administration/clusters" }, - { - "text": "Quotas", - "link": "/administration/quotas" - }, { "text": "Types d'environnement", "link": "/administration/environnements" diff --git a/docs/administration/quotas.md b/docs/administration/quotas.md deleted file mode 100644 index 70cb57b..0000000 --- a/docs/administration/quotas.md +++ /dev/null @@ -1,26 +0,0 @@ -# Quotas - -Un quota est une limite dure (en terme de CPU et de RAM) de ce qu'un projet peut déployer sur un environnement donné. - -Dans le monde kubernetes, cela se traduit par un objet de type ResourceQuota dans le namespace. - -## Création d'un nouveau quota - -Cliquer sur le bouton **+ Ajouter un nouveau quota**, une nouvelle page s'ouvre demandant un certain nombre détail. - -Un exemple ci-dessous pour la création d'un quota, l'explication des champs se trouvant après: -![quota création](/img/console_admin/quota_creation.png) - -1. **Nom du quota**: Nom que le quota aura sur la partie cliente de la console -2. **Mémoire allouée**: Mémoire maximum que le projet pourra allouer s'il choisit ce quota -3. **CPU alloué(s)**: Nombre de CPU maximum que le projet pourra allouer s'il choisit ce quota -4. **Quota privé**: Si le quota est uniquement accessible aux administrateurs de la console -5. **Nom des types d'environnement**: A quels environnement ce quota est associé - -## Mise à jour du quota et suppression - -Pour mettre à jour un quota, il suffit de cliquer sur sa tuile dans la page principal des quotas. - -Si le quota est utilisé par des projets, la liste des projets et environnement est affichée. - -Un quota ne peut être supprimé que s'il n'a pas de projet lié. diff --git a/docs/guide/environments-management.md b/docs/guide/environments-management.md index 2234464..e13c6f0 100644 --- a/docs/guide/environments-management.md +++ b/docs/guide/environments-management.md @@ -4,22 +4,36 @@ Depuis la console il est possible de créer des environnements applicatifs pour Un environnement correspond à un namespace sur un cluster pour son projet applicatif. -La console crée automatiquement : - - un namespace applicatif par environnement sur le cluster correspondant. - - le pullsecret associé au projet. +pour chaque environnement, la console crée automatiquement : + - un namespace applicatif sur le cluster correspondant. + - le pullsecret associé au projet correspondant au credentials d'accès au repository Harbor de son projet. - les quotas correspondant à l'environnement sur le namespace - - une application ArgoCD par environnement et par dépôt de code infrastructure. + - une application ArgoCD pour chaque dépôt de code infrastructure. - ## Création d'un environnement +## Gestion des quotas sur un projet - Depuis la console aller dans l'onglet ressources ![ressources](/img/environnement/menu.png) +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. + +![type](/img/environnement/quotas-projet.png) + +Afin d'assurer la rétro compatibilité avec les anciens projets, il est également possible de supprimer les limites mais cette fonction sera, à terme, supprimée. + + ## Création d'un environnement et quotas associés + +Depuis la console aller dans l'onglet ressources ![ressources](/img/environnement/menu.png) Cliquez sur le bouton **+ Ajouter un nouvel environnement** puis compléter : - Un nom à l'environnement, par exemple integration - - Un type environnement (dev / staging / integration / prod), celui-ci donne accès à des quotas différents + - Un type d'environnement (dev / staging / integration / prod), celui-ci donne accès à des clusters différents et permet d'associer les ressources de type **production** ou **hors production** ![type](/img/environnement/type-env.png) - - Un dimensionnement (quota) - ![quota](/img/environnement/quota-env.png) - Le cluster de destination - ![quota](/img/environnement/cluster-env.png) + ![cluster](/img/environnement/cluster-env.png) + - Les quotas de l'environnement pour la mémoire, CPU et GPU. Si un projet n'a pas besoin de GPU mettre 0 dans les GPU. + ![quota](/img/environnement/quotas-new.png) + +> 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) \ No newline at end of file diff --git a/docs/public/img/environnement/environnement-quota.png b/docs/public/img/environnement/environnement-quota.png new file mode 100644 index 0000000..4086277 Binary files /dev/null and b/docs/public/img/environnement/environnement-quota.png differ diff --git a/docs/public/img/environnement/quotas-new.png b/docs/public/img/environnement/quotas-new.png new file mode 100644 index 0000000..15d9ce8 Binary files /dev/null and b/docs/public/img/environnement/quotas-new.png differ diff --git a/docs/public/img/environnement/quotas-projet.png b/docs/public/img/environnement/quotas-projet.png new file mode 100644 index 0000000..b1f2229 Binary files /dev/null and b/docs/public/img/environnement/quotas-projet.png differ