doc-locale/fr-fr/ci/environments/kubernetes_dashboard.md
{{< details >}}
{{< /details >}}
{{< history >}}
environment_settings_to_graphql, kas_user_access, kas_user_access_project et expose_authorized_cluster_agents. Cette fonctionnalité est en bêta.environment_settings_to_graphql a été supprimé dans GitLab 16.2.kas_user_access, kas_user_access_project et expose_authorized_cluster_agents ont été supprimés dans GitLab 16.2.{{< /history >}}
Utilisez le tableau de bord pour Kubernetes afin de comprendre le statut de vos clusters grâce à une interface visuelle intuitive. Le tableau de bord fonctionne avec chaque cluster Kubernetes connecté, que vous les ayez déployés avec CI/CD ou GitOps.
{{< history >}}
kubernetes_namespace_for_environment. Désactivé par défaut.kubernetes_namespace_for_environment a été supprimé.flux_resource_for_environment.flux_resource_for_environment a été supprimé.{{< /history >}}
Configurez un tableau de bord pour l'utiliser dans un environnement donné. Vous pouvez configurer un tableau de bord pour un environnement qui existe déjà, ou en ajouter un lors de la création d'un environnement.
Prérequis :
user_access est configuré pour le projet de l'environnement ou son groupe parent.{{< tabs >}}
{{< tab title="L'environnement existe déjà" >}}
{{< /tab >}}
{{< tab title="L'environnement n'existe pas" >}}
{{< /tab >}}
{{< /tabs >}}
{{< history >}}
{{< /history >}}
Pour configurer un tableau de bord pour un environnement dynamique :
.gitlab-ci.yml. Vous devez spécifier le chemin complet vers le projet de configuration de l'agent, suivi d'un deux-points et du nom de l'agent.Par exemple :
deploy_review_app:
stage: deploy
script: make deploy
environment:
name: review/$CI_COMMIT_REF_SLUG
kubernetes:
agent: path/to/agent/project:agent-name
Pour plus d'informations, consultez la référence de syntaxe YAML CI/CD.
{{< history >}}
k8s_watch_api. Désactivé par défaut.k8s_watch_api a été supprimé.{{< /history >}}
Affichez un tableau de bord pour voir le statut des clusters connectés. Le statut de vos ressources Kubernetes et le rapprochement Flux sont mis à jour en temps réel.
Pour afficher un tableau de bord configuré :
Une liste de pods s'affiche. Sélectionnez un pod pour afficher ses détails.
{{< history >}}
flux_resource_for_environment.flux_resource_for_environment a été supprimé.{{< /history >}}
Vous pouvez consulter le statut de synchronisation de vos déploiements Flux depuis un tableau de bord. Pour afficher le statut du déploiement, votre tableau de bord doit pouvoir récupérer les ressources Kustomization et HelmRelease, ce qui nécessite qu'un espace de nommage soit configuré pour l'environnement.
GitLab recherche les ressources Kustomization et HelmRelease spécifiées par la liste déroulante Flux resource dans les paramètres de l'environnement.
Un tableau de bord affiche l'un des badges de statut suivants :
| Statut | Description |
|---|---|
| Rapprochement fait | Le déploiement a été rapproché avec succès de son environnement. |
| Rapprochement en cours | Un rapprochement est en cours. |
| Point mort | Un rapprochement est bloqué en raison d'une erreur qui ne peut pas être résolue sans intervention humaine. |
| Échec | Le déploiement n'a pas pu être rapproché en raison d'une erreur irrécupérable. |
| Inconnu(e) | Le statut de synchronisation du déploiement n'a pas pu être récupéré. |
| Non disponible | La ressource Kustomization ou HelmRelease n'a pas pu être récupérée. |
{{< history >}}
{{< /history >}}
Vous pouvez rapprocher manuellement votre déploiement avec ses ressources Flux.
Pour déclencher un rapprochement :
{{< history >}}
{{< /history >}}
Vous pouvez suspendre ou reprendre manuellement votre rapprochement Flux depuis l'interface utilisateur.
Pour suspendre ou reprendre le rapprochement :
{{< history >}}
{{< /history >}}
Affichez les journaux de pod lorsque vous souhaitez comprendre rapidement et résoudre les problèmes dans vos environnements depuis un tableau de bord configuré. Vous pouvez afficher les journaux pour chaque conteneur dans un pod.
Vous pouvez également afficher les journaux de pod depuis les détails du pod.
{{< history >}}
{{< /history >}}
Pour redémarrer un pod en échec, supprimez-le depuis le tableau de bord Kubernetes.
Pour supprimer un pod :
Vous pouvez également supprimer un pod depuis les détails du pod.
{{< history >}}
k8s_dashboard. Désactivé par défaut.{{< /history >}}
[!flag] La disponibilité de cette fonctionnalité est contrôlée par un feature flag. Pour plus d'informations, consultez l'historique. Cette fonctionnalité est disponible à des fins de test, mais n'est pas prête pour une utilisation en production.
Le tableau de bord détaillé fournit des informations sur les ressources Kubernetes suivantes :
Chaque tableau de bord affiche une liste de ressources avec leurs statuts, espaces de nommage et leur ancienneté. Vous pouvez sélectionner une ressource pour ouvrir un panneau contenant davantage d'informations, notamment les labels et le statut au format YAML, les annotations et les spécifications.
En raison du changement de priorité décrit dans ce ticket, les travaux sur le tableau de bord détaillé sont suspendus.
Pour fournir un retour sur le tableau de bord détaillé, consultez le ticket 460279.
Prérequis :
user_access.Le tableau de bord détaillé n'est pas accessible depuis la navigation dans la barre latérale. Pour afficher un tableau de bord détaillé :
Trouvez l'ID de votre agent pour Kubernetes :
Accédez à l'une des URL suivantes en remplaçant <agent_id> par l'ID de votre agent :
| Type de ressource | URL |
|---|---|
| Pods | https://myinstance.gitlab.com/-/kubernetes/<agent_id>/pods |
| Services | https://myinstance.gitlab.com/-/kubernetes/<agent_id>/services |
| Déploiements | https://myinstance.gitlab.com/-/kubernetes/<agent_id>/deployments |
| ReplicaSets | https://myinstance.gitlab.com/-/kubernetes/<agent_id>/replicaSets |
| StatefulSets | https://myinstance.gitlab.com/-/kubernetes/<agent_id>/statefulSets |
| DaemonSets | https://myinstance.gitlab.com/-/kubernetes/<agent_id>/daemonSets |
| Jobs | https://myinstance.gitlab.com/-/kubernetes/<agent_id>/jobs |
| CronJobs | https://myinstance.gitlab.com/-/kubernetes/<agent_id>/cronJobs |
Lorsque vous utilisez le tableau de bord pour Kubernetes, vous pouvez rencontrer les problèmes suivants.
Vous pourriez obtenir une erreur indiquant Error: services is forbidden: User "gitlab:user:<user-name>" cannot list resource "<resource-name>" in API group "" at the cluster scope.
Cette erreur se produit lorsqu'un utilisateur n'est pas autorisé à effectuer l'opération spécifiée dans le RBAC Kubernetes.
Pour résoudre ce problème, vérifiez votre configuration RBAC. Si le RBAC est correctement configuré, contactez votre administrateur Kubernetes.
Lorsque vous configurez un nouvel environnement, la liste déroulante Agent GitLab peut être vide, même si vous avez configuré des clusters Kubernetes.
Pour remplir la liste déroulante Agent GitLab, accordez à un agent l'accès Kubernetes avec le mot-clé user_access.