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.
- Images de conteneur: images de conteneur, graphiques Helm
- Packages de langages: Java, Node.js, Python
- Packages de système d'exploitation
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.
- Images de conteneurs: Docker et Helm
- Packages de langage: Java, Node.js, Python, Go
- Packages de système d'exploitation: Debian et RPM
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