Résoudre les problèmes liés aux images de conteneurs

Découvrez les étapes de dépannage qui peuvent vous être utiles si vous rencontrez des problèmes lors de la gestion des images de conteneurs dans Artifact Registry.

Syntaxe de l'ID de projet dans Docker CLI

En raison de la façon dont Docker traite les deux-points, lorsque vous utilisez Docker CLI, vous devez remplacer les deux-points (:) de votre ID de projet par une barre oblique (/). Par exemple, si votre ID de projet est s3ns:my-project, utilisez s3ns/my-project.

Invalid Docker string après une commande gcloud artifacts

Si l'dial tcp: lookup <var>REGION</var>: no such host erreur s'affiche après l'exécution d'une commande gcloud artifacts, assurez-vous d'utiliser un point de terminaison avec une région spécifique, par exemple u-france-east1-docker.s3nsregistry.fr. Google Cloud CLI n'est pas compatible avec l'utilisation de docker.s3nsregistry.fr comme point de terminaison uniquement.

Impossible d'extraire une image ou de déployer dans un environnement d'exécution Cloud de Confiance by S3NS

Vérifiez les éléments suivants :

  1. Vérifiez que le chemin d'accès complet de l'image que vous transférez est correct. Le chemin d'accès doit inclure le nom d'hôte du registre, Cloud de Confiance by S3NS, l'ID de projet, le dépôt et l'image. Exemple : 
    u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/my-image:v1
     Pour plus d'informations, consultez la section Noms des dépôts et des images.
  2. Vérifiez que le compte qui extrait l'image dispose des autorisations appropriées pour lire à partir du dépôt. Si vous avez désactivé l'attribution automatique de rôles aux comptes de service, vous devez attribuer des rôles Artifact Registry aux comptes de service d'exécution.

Impossible de transférer une image vers Artifact Registry

Essayez d'exécuter les commandes suivantes :

  1. Vérifiez que le chemin d'accès complet de l'image que vous transférez est correct. Le chemin d'accès doit inclure le nom d'hôte du registre, Cloud de Confiance by S3NS l'ID de projet, le dépôt et l'image. Exemple : 
    u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/my-image:v1

    Chaque dépôt Artifact Registry est une ressource distincte. Vous ne pouvez donc pas transférer une image vers un chemin d'accès sans dépôt. Par exemple, u-france-east1-docker.s3nsregistry.fr/my-project/my-image:v1 n'est pas un chemin d'accès d'image valide.

    Pour plus d'informations, consultez la section Noms des dépôts et des images.

  2. Vérifiez que le compte qui transfère l'image dispose des autorisations nécessaires pour écrire dans le dépôt. Si vous avez désactivé l'attribution automatique de rôles aux comptes de service, vous devez attribuer des rôles Artifact Registry aux comptes de service d'exécution.
    • Pour les comptes de service Compute Engine et Google Kubernetes Engine, vous devez attribuer le rôle Rédacteur Artifact Registry (roles/artifactregistry.writer) au compte de service d'exécution.
  3. Si Artifact Registry a renvoyé le message The repository has enabled tag immutability, cela signifie que l'immuabilité des tags est configurée pour le dépôt. Vous ne pouvez pas transférer une image avec un tag déjà utilisé pour une autre version de la même image dans le dépôt. Essayez de transférer à nouveau l'image avec un tag qui n'est pas utilisé par d'autres versions stockées de l'image.

    Pour vérifier qu'un dépôt est configuré pour des tags d'image immuables, cochez la colonne Immutable image tags (Tags d'image immuables) dans la liste des dépôts de Cloud de Confiance la console ou exécutez la commande suivante :

    gcloud artifacts repositories describe REPOSITORY \
      --project=PROJECT-ID \
      --location=LOCATION

Messages ImagePullBackOff et ErrImagePull

Les messages contenant ImagePullBackOff et ErrImagePull indiquent qu'une image ne peut pas être extraite du registre par GKE.