Dépannage d'ordre général

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

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

Les informations suivantes vous aideront à diagnostiquer les erreurs liées à un emplacement de dépôt non valide ou à un nom de dépôt non valide.

Paramètres par défaut des emplacements et des dépôts pour gcloud

Si vous définissez un dépôt et un emplacement par défaut dans la Google Cloud CLI afin de pouvoir omettre les indicateurs --location et --repository des commandes gcloud artifacts, essayez d'exécuter la commande qui a échoué avec les indicateurs et les valeurs correspondantes. Pour en savoir plus sur la syntaxe d'une commande particulière, exécutez la commande avec l'option --help.

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

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

Si votre commande échoue encore, 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 la stratégie rétroactivement sur les dépôts qui sont antérieurs aux restrictions d'emplacement.

Noms de dépôt dans les commandes gcloud

Vous pouvez répertorier les dépôts pour afficher leur nom 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: MAVEN
DESCRIPTION:
LOCATION: us-east1
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'indicateur --repository:

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

Cette commande utilise le nom du dépôt uniquement sans indicateur:

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 de dépôt complet lors de la configuration des clients, tel que us-east1-docker.pkg.dev/my-project/my-repo. Vous devez ensuite suivre les conventions du client pour importer et télécharger des packages. Pour en savoir plus sur la configuration et l'utilisation du client, reportez-vous à 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'accès d'image qui n'inclut qu'un ID de projet.

  • Chemin d'accès non valide: us-east1-docker.pkg.dev/my-project/my-image
  • Chemin d'accès valide: us-east1-docker.pkg.dev/my-project/my-repo/my-image

Impossible de transférer ou d'extraire des dépôts non supprimés

Les dépôts ne fonctionnent plus correctement après l'annulation de la suppression d'un projet Google Cloud ou l'activation de 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