Ce document fournit une présentation des dépôts distants. Pour obtenir des instructions sur la création d'un dépôt distant, consultez la section Créer des dépôts distants.
Les quotas et limites d'Artifact Registry s'appliquent aux dépôts distants.
Fonctionnement des dépôts distants
Les dépôts distants stockent des artefacts provenant de sources externes prédéfinies telles que Docker Hub, Maven Central, l'index de packages Python (PyPI), Debian ou CentOS, ainsi que des sources définies par l'utilisateur pour les formats compatibles. Un dépôt distant fait office de proxy pour la source externe, ce qui vous permet de mieux contrôler vos dépendances externes. La première fois que vous demandez une version d'un package, Artifact Registry télécharge et met en cache le package dans le dépôt distant. La prochaine fois que vous demanderez la même version du package, Artifact Registry diffusera la copie mise en cache.
Si vous demandez un artefact à une source en amont qui n'existe pas ou ne contient pas la version que vous avez spécifiée, la requête échoue.
Les autres modes de dépôt sont les suivants:
- Standard: mode de dépôt par défaut. Vous importez ou publiez des artefacts tels que des packages privés directement dans des dépôts standards. Bien que vous puissiez effectuer des téléchargements directement à partir de dépôts standards individuels, accéder à des groupes de dépôts via un dépôt virtuel simplifie la configuration des outils.
- Virtuel: dépôt servant de point d'accès unique pour plusieurs dépôts en amont, y compris les dépôts distants et standards.
Authentification en amont
Les dépôts distants Artifact Registry sont compatibles avec l'authentification de base pour les sources en amont prédéfinies et définies par l'utilisateur pour les formats compatibles. Pour en savoir plus sur l'authentification auprès des sources en amont du dépôt distant, consultez la section Configurer l'authentification auprès des sources en amont du dépôt distant.
Cas d'utilisation et avantages
- Accès plus rapide et plus fiable aux artefacts
- Le stockage de copies mises en cache de vos dépendances publiques dans Artifact Registry réduit la latence lorsque d'autres services Google Cloud récupèrent des images. Les artefacts mis en cache sont également disponibles si le dépôt public externe est hors connexion en raison d'une panne ou d'un autre problème.
- Résolution plus sécurisée des dépendances
Utilisez des dépôts distants avec des dépôts virtuels pour atténuer les risques associés aux dépendances publiques. Certains outils ne permettent pas de contrôler l'ordre des recherches lorsqu'une combinaison de dépôts privés et publics est configurée dans le client. Ce type de configuration est vulnérable à une attaque par conflit de dépendance, qui consiste à importer une nouvelle version d'un package avec un code incorrect dans un dépôt public pour inciter les clients à choisir la mauvaise version.
Au lieu de configurer les clients directement pour effectuer des recherches dans plusieurs dépôts, vous pouvez configurer des dépôts virtuels pour donner la priorité à vos dépôts privés par rapport aux dépôts distants.
Si Artifact Registry se trouve dans un périmètre de service VPC Service Controls, par défaut, Artifact Registry refuse l'accès aux sources en amont situées en dehors du périmètre. Pour autoriser les dépôts distants d'un emplacement spécifique à accéder à leurs sources externes configurées en dehors du périmètre, consultez les instructions relatives à la configuration de VPC Service Controls.
Pour en savoir plus sur d'autres bonnes pratiques de gestion des dépendances, consultez la page Gestion des dépendances.
Mises à jour des index et des métadonnées des packages
Les fichiers modifiables tels que les index de package et les métadonnées sont mis à jour à partir de la source en amont lorsqu'ils dépassent l'âge par défaut. Les valeurs par défaut de types de fichiers spécifiques sont listées dans le tableau suivant:
Format | Type de fichier | Âge par défaut pour la mise à jour |
---|---|---|
Maven | maven-metadata.xml |
5 minutes |
archetype-catalog.xml |
1 heure | |
Npm | Fichiers manifestes | 5 minutes |
Python | Fichiers d'index | 1 heure |
Docker | Cache de liste/obtention des tags | 1 heure |
Apt/Miam (preview) | Fichiers d'index | 2 minutes |
Fichiers de package | 72 heures |
Formats compatibles
Consultez les sections suivantes pour connaître les formats disponibles pour les dépôts distants prédéfinis et définis par l'utilisateur.
Préréglages en amont
Vous pouvez créer des dépôts distants pour les formats de dépôt suivants et les sources en amont prédéfinies correspondantes:
Format | types de package | URL en amont | Nom du préréglage en amont |
---|---|---|---|
Docker | Publique ou privée | https://registry-1.docker.io. | DOCKER-HUB |
Maven | Publique ou privée | https://repo.maven.apache.org/maven2 | MAVEN-CENTRAL |
npm | Publique ou privée | https://registry.npmjs.org | NPMJS |
Python | Public | https://pypi.io | PYPI |
Packages OS (preview) | Public | Consultez la section Packages d'OS compatibles en amont. | Consultez la section Packages d'OS compatibles en amont. |
Packages d'OS prédéfinis en amont
Vous pouvez créer un dépôt distant pour un package d'OS en choisissant une base de dépôt et en personnalisant le reste de l'URL pour le dépôt spécifique. Les bases de dépôts suivantes sont compatibles:
Appt
Dépôt | Préfixe d'URL | Nom de base du dépôt |
---|---|---|
Debian | http://deb.debian.org | DÉBIAN |
Ubuntu LTS ou Pro | http://archive.ubuntu.com | UBUNTU |
Miam
Dépôt | Préfixe d'URL | Nom de base du dépôt |
---|---|---|
CentOS | http://mirror.centos.org | CENTOS |
http://debuginfo.centos.org | CENTOS_DEBUG | |
https://vault.centos.org | CENTOS_VAULT | |
https://mirror.stream.centos.org | CENTOS_STREAM | |
Rocky | http://dl.rockylinux.org | ROCKY |
Fedora Extra Packages for Enterprise Linux (EPEL) | https://dl.fedoraproject.org/pub/epel | ÉPALE |
En amont définis par l'utilisateur
Vous pouvez créer des dépôts distants pour les sources en amont définies par l'utilisateur aux formats suivants:
- Docker
- npm
- Maven
- Python
Le tableau non exhaustif suivant répertorie certains URI en amont courants.
Format | URI en amont | Nom du registre |
---|---|---|
Docker | https://public.ecr.aws | AWS ECR Public Gallery |
Docker | https://registry.k8s.io | Kubernetes Container Registry |
Docker | https://MY_ARTIFACTORY_INSTANCE.jfrog.io | Jfrog Artifactory |
Docker | https://MY_NEXUS_IP | Nexus |
npm | https://npm.pkg.github.com | Registre Npm GitHub |
npm | https://MY_ARTIFACTORY_INSTANCE.jfrog.io/artifactory/api/npm/MY_UPSTREAM_REPOSITORY | Jfrog Artifactory |
npm | https://MY_NEXUS_IP/repository/MY_UPSTREAM_REPOSITORY | Nexus |
Maven | https://MY_ARTIFACTORY_INSTANCE.jfrog.io/artifactory/MY_UPSTREAM_REPOSITORY | Jfrog Artifactory |
Maven | https://MY_NEXUS_IP/repository/MY_UPSTREAM_REPOSITORY | Nexus |
Python | https://MY_ARTIFACTORY_INSTANCE.jfrog.io/artifactory/api/pypi/MY_UPSTREAM_REPOSITORY | Jfrog Artifactory |
Python | https://MY_NEXUS_IP/repository/MY_UPSTREAM_REPOSITORY | Nexus |
Où
- MY_ARTIFACTORY_INSTANCE est le nom de votre instance en amont Jfrog Artifactory.
- MY_NEXUS_IP est l'adresse IP et le port de votre instance en amont Nexus.
- MY_UPSTREAM_REPOSITORY est le nom de votre dépôt en amont (utilisé dans les exemples Nexus et Artifactory).
Limites
En plus des quotas et des limites d'Artifact Registry, les dépôts distants sont soumis aux limitations suivantes:
- Les dépôts distants Maven ne permettent pas de définir la règle de version sur "instantané" ou "release".
Étapes suivantes
- Créez des dépôts distants.
- Pour en savoir plus sur les dépôts Artifact Registry, consultez la présentation des dépôts.