Dépannage d'ordre général

Découvrez les étapes de dépannage qui s'appliquent à tous les formats d'artefacts lorsque vous utilisez Artifact Registry. Pour les problèmes spécifiques à un format d'artefact, consultez la page spécifique au format.

Dépôt ou emplacement non valide dans les commandes

Utilisez les informations suivantes pour diagnostiquer les erreurs d'emplacement ou de nom de dépôt non valides.

Emplacement et dépôt par défaut pour gcloud

Si vous définissez un répertoire et un emplacement par défaut dans la Google Cloud CLI afin de pouvoir omettre les options --location et --repository des commandes gcloud artifacts, essayez d'exécuter la commande ayant échoué avec les options et les valeurs correspondantes. Pour en savoir plus sur la syntaxe d'une commande spécifique, exécutez-la avec l'option --help.

Le paramètre de dépôt par défaut ne s'applique pas aux commandes gcloud artifacts dans lesquelles vous spécifiez un nom de dépôt sans l'indicateur --repository. Par exemple, vous devez spécifier le nom du dépôt dans une commande gcloud artifacts repositories describe, comme dans l'exemple suivant:

gcloud artifacts repositories describe my-repo --location=us-west1

Si votre commande échoue toujours, vous devrez peut-être vérifier que vous avez spécifié des valeurs valides pour le dépôt ou l'emplacement.

Zone du dépôt

Pour répertorier tous les emplacements Artifact Registry compatibles, exécutez la commande suivante:

gcloud artifacts locations list

Votre règle d'administration peut inclure des restrictions d'emplacement. Artifact Registry applique ces restrictions au moment de la création du dépôt. Artifact Registry n'applique pas les règles rétroactivement aux dépôts antérieurs aux restrictions d'emplacement.

Noms de dépôts dans les commandes gcloud

Vous pouvez lister des dépôts pour afficher les noms de dépôt dans un projet ou un emplacement spécifié.

Pour répertorier tous les dépôts d'un projet, exécutez la commande suivante:

gcloud artifacts repositories list --project=PROJECT-ID \
    --location=all

Pour répertorier tous les dépôts d'un emplacement, exécutez la commande suivante:

gcloud artifacts repositories list --project=PROJECT-ID \
    --location=LOCATION

Remplacez PROJECT-ID par l'ID de votre projet Google Cloud et LOCATION par l'emplacement du dépôt.

La commande renvoie des informations pour chaque dépôt, semblables à l'exemple suivant:

REPOSITORY: my-repo
FORMAT: DOCKER
DESCRIPTION:
LOCATION: us-west1
LABELS:
ENCRYPTION: Google-managed key
CREATE_TIME: 2021-09-23T19:39:10
UPDATE_TIME: 2021-09-23T19:39:10

La valeur de REPOSITORY est celle que vous utilisez avec les commandes gcloud artifacts qui incluent le nom du dépôt en tant que paramètre.

Par exemple, cette commande utilise l'option --repository:

gcloud artifacts packages list --location=us-west1 --repository=my-repo

Cette commande n'utilise que le nom du dépôt, sans option:

gcloud artifacts repositories describe my-repo --location=us-west1

Noms de dépôts avec des clients tiers

Pour les clients tiers, vous utilisez généralement un chemin d'accès complet au dépôt lorsque vous configurez des clients, tels que us-west1-docker.pkg.dev/my-project/my-repo. Vous suivez ensuite les conventions du client pour importer et télécharger des packages. Pour en savoir plus sur la configuration et l'utilisation du client, consultez la documentation du format que vous utilisez.

Si vous effectuez la transition depuis Container Registry, notez que tous les chemins d'accès aux images doivent inclure un nom de dépôt Artifact Registry. Vous ne pouvez pas spécifier un chemin d'image qui n'inclut qu'un ID de projet.

  • Chemin non valide: us-east1-docker.pkg.dev/my-project/my-image
  • Chemin valide: us-east1-docker.pkg.dev/my-project/my-repo/my-image

Impossible d'effectuer des transferts depuis des dépôts non supprimés

Les dépôts ne fonctionnent plus correctement après avoir rétabli un projet Google Cloudou activé l'API Artifact Registry après l'avoir désactivée.

Si vous désactivez l'API Artifact Registry ou supprimez le projet, les services Artifact Registry deviennent indisponibles. Artifact Registry supprime les données du dépôt au bout de sept jours.

En savoir plus sur la suppression des données sur Google Cloud