Cette page a été traduite par l'API Cloud Translation.

Stocker des modules Go dans Artifact Registry

Configurer un dépôt Go Artifact Registry privé, importer un module et de l'utiliser comme dépendance.

Avant de commencer

Connectez-vous à votre compte Google.

Si vous n'en possédez pas déjà un, vous devez en créer un.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Vérifiez que la facturation est activée pour votre projet Google Cloud.

Activez l'API Artifact Registry

Activer l'API

Installez Google Cloud CLI.

Pour initialiser gcloudCLI, exécutez la commande suivante :

gcloud init

Remarque : Si vous avez déjà installé gcloud CLI, assurez-vous que vous disposez de la dernière version en exécutant

gcloud components
      update

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Vérifiez que la facturation est activée pour votre projet Google Cloud.

Activez l'API Artifact Registry

Activer l'API

Installez Google Cloud CLI.

Pour initialiser gcloudCLI, exécutez la commande suivante :

gcloud init

Remarque : Si vous avez déjà installé gcloud CLI, assurez-vous que vous disposez de la dernière version en exécutant

gcloud components
      update

Installez Go 1.15 ou une version ultérieure.
Installez le module complémentaire gcloud CLI package-go-module:
```
gcloud components install package-go-module
```

Créer un dépôt

Pour créer et configurer un dépôt :

Exécutez la commande suivante pour créer un dépôt.
```
gcloud artifacts repositories create REPOSITORY \
    --repository-format=go \
    --location=LOCATION \
    --description=DESCRIPTION
```
Remplacez les éléments suivants :
- REPOSITORY est le nom du dépôt. Pour chaque emplacement de dépôt d'un projet, les noms de dépôt doivent être uniques.
- LOCATION est l'emplacement régional ou multirégional lieu pour le dépôt. Vous pouvez omettre cet indicateur si vous définissez default Pour afficher la liste des emplacements pris en charge, exécutez la commande gcloud artifacts locations list
- DESCRIPTION est une description facultative du dépôt. À ne pas faire inclure des données sensibles, car les descriptions de référentiel ne sont pas chiffrées.

Exécutez la commande suivante pour afficher les détails du dépôt.

  gcloud artifacts repositories describe --location=LOCATION REPOSITORY

Le résultat se présente comme suit :

  Encryption: Google-managed key
  Repository Size: 0.000MB
  createTime: '2022-06-03T20:20:01.644813Z'
  format: GO
  mode: STANDARD_REPOSITORY
  name: projects/my-project/locations/us-west1/repositories/my-repo
  updateTime: '2022-06-03T20:20:01.644813Z'

Définir des valeurs par défaut pour les commandes gcloud

Vous pouvez simplifier vos commandes gcloud CLI en la configuration des paramètres par défaut pour les valeurs de projet, de dépôt et d'emplacement. Une fois les valeurs par défaut configurées, Vous n'avez pas besoin des tags --project, --location et --repository.

Empaqueter et importer un module Go

Le module complémentaire de gcloud CLI package-go-module regroupe vos modules Go, Vous pouvez ainsi gérer les versions et les importer dans Artifact Registry à l'aide de l'API gcloud .

Créer un module Go

Commencez par créer un module Go simple à importer dans votre dépôt.

Dans votre répertoire d'accueil, créez un répertoire nommé "foo". pour votre module
```
mkdir foo
```
Changez de répertoire dans le répertoire de votre module et exécutez go mod init pour créer un fichier go.mod pour votre module.
```
  cd foo \
  go mod init example.com/foo
```
Remplacez example.com/foo par le chemin d'accès au module. Consultez le Documentation de référence sur les modules Go pour en savoir plus.
Dans votre répertoire "foo", créez un fichier foo.go avec le contenu suivant:
```
package foo

const HelloWorld = "Hello World!"
```

Empaqueter et importer le module

Empaquetez et importez le module dans votre dépôt:

  gcloud artifacts go upload --project=PROJECT \
      --repository=REPOSITORY \
      --location=LOCATION \
      --module-path=example.com/foo \
      --version=VERSION \
      --source=SOURCE_LOCATION

Remplacez les éléments suivants :

PROJECT par l'ID de votre projet Google Cloud.
REPOSITORY par le nom du dépôt dans lequel package est stocké.
LOCATION avec l'emplacement régional ou multirégional lieu du dépôt.
example.com/foo par le chemin d'accès au module. Consultez le Documentation de référence sur les modules Go pour en savoir plus.
VERSION avec le version sémantique du module sous la forme vX.Y.Z, où X est la version majeure, Y est la version mineure, et Z est la version de correctif.
SOURCE_LOCATION par le chemin d'accès au répertoire racine de votre environnement Go. de ce module. Si vous omettez l'option --source, le répertoire actuel est la valeur par défaut.

Le module est importé dans Artifact Registry.

Pour en savoir plus sur la création de modules Go, consultez cette tutoriel.

Répertorier les modules

Exécutez la commande suivante pour inspecter le module Go importé dans le fichier par défaut le projet, le dépôt et l'emplacement lorsque les valeurs par défaut sont configurées:

  gcloud artifacts packages list

Le résultat se présente comme suit :

  Listing items under project my-project, location us-west1, repository my-repo.

  PACKAGE                   CREATE_TIME          UPDATE_TIME
  example.com/foo           2022-06-03T20:43:39  2022-06-20T20:37:40

Afficher les détails de la version du module

Exécutez la commande suivante pour afficher les versions de votre module dans les le projet, le dépôt et l'emplacement valeurs par défaut sont configurées:

  gcloud artifacts versions list --package=MODULE_PATH

Le résultat se présente comme suit :

  Listing items under project my-project, location us-west1, repository my-repo, package example.com/foo.

  VERSION  DESCRIPTION  CREATE_TIME          UPDATE_TIME
  v0.1.0                2022-06-03T20:43:39  2022-06-03T20:43:39
  v0.1.1                2022-06-20T20:37:40  2022-06-20T20:37:40

Télécharger des modules

Pour importer des modules stockés dans Artifact Registry, vous devez demander à Go rechercher les dépendances d'Artifact Registry et contourner base de données de somme de contrôle.

Configurer l'environnement Go

Demandez à Go de télécharger des modules depuis Artifact Registry, le service public Go module proxy, puis "source" dans cet ordre:
```
  export GOPROXY=https://LOCATION-go.pkg.dev/PROJECT/REPOSITORY,https://proxy.golang.org,direct
```
Remplacez les éléments suivants :
- LOCATION est l'emplacement régional ou multirégional lieu du dépôt.
- PROJECT est votre Google Cloud ID du projet.
- REPOSITORY est le nom du dépôt dans lequel package est stocké.
Excluez votre module de la vérification à l'aide de la base de données publique des sommes de contrôle:
```
  export GONOSUMDB=MODULE_PATH_REGEX
```
Remplacez MODULE_PATH_REGEX par le chemin d'accès de votre module ou par une expression régulière. si vous souhaitez exclure plusieurs modules.

Pour empêcher la vérification de votre module example.com/foo à l'aide de la règle de la base de données de contrôle, exécutez la commande suivante:
```
  export GONOSUMDB=example.com/foo
```
Si vous souhaitez que tous les modules dont le chemin d'accès commence par example.com exclu de la vérification à l'aide de la base de données publique des sommes de contrôle, exécutez la la commande suivante:
```
  export GONOSUMDB=example.com/*
```

S'authentifier dans Artifact Registry

Lors du téléchargement de modules Go empaquetés à utiliser comme dépendances à partir de Artifact Registry, le binaire Go utilise les identifiants de votre fichier netrc pour s'authentifier auprès d'Artifact Registry. Pour simplifier l'authentification vous pouvez utiliser l'assistant d'identification Go pour actualiser les jetons netrc pour l'authentification auprès d'Artifact Registry.

L'emplacement de votre fichier netrc peut être défini à l'aide de la variable d'environnement netrc. Si la variable NETRC n'est pas définie, la commande go lit $HOME/.netrc sur les plates-formes de type UNIX ou %USERPROFILE%\_netrc sous Windows.

Artifact Registry est compatible avec les méthodes d'authentification suivantes.

Identifiants de courte durée (recommandé): Utiliser l'outil d'aide à la connexion Go d'Artifact Registry pour mettre à jour les jetons d'authentification dans votre fichier netrc.
Utiliser une clé de compte de service: Utilisez cette option lorsque vous ne pouvez pas utiliser les identifiants dans votre environnement pour l'authentification unique. Ajoutez la clé de compte de service non chiffrée à votre fichier netrc.

Remarque : Les clés de compte de service constituent un risque pour la sécurité si elles ne sont pas gérées correctement. Dans la mesure du possible, vous devez choisir une alternative plus sécurisée aux clés de compte de service. Si vous devez vous authentifier avec une clé de compte de service, vous êtes responsable de la sécurité de la clé privée et des autres opérations décrites dans la section Bonnes pratiques pour la gestion des clés de compte de service. Si vous ne parvenez pas à créer une clé de compte de service, la création de clé de compte de service peut être désactivée pour votre organisation. Pour en savoir plus, consultez la page Gérer les ressources d'organisation sécurisées par défaut.

Ajouter l'assistant d'identification Go à `GONOPROXY`

Avant d'utiliser l'assistant d'identification Go, vous devez l'ajouter à la liste GONOPROXY pour forcer Go à le télécharger directement à partir de GitHub. Si vous avez d'autres modules à télécharger directement à partir de la source. Ajoutez-les en les séparant par une virgule comme illustré dans l'exemple suivant:

  export GONOPROXY=MODULE_PATH1, MODULE_PATH2

Où MODULE_PATH1 et MODULE_PATH2 sont les chemins d'accès aux modules à télécharger de la source.

Pour ajouter l'assistant d'identification Go à votre liste GONOPROXY et l'exécuter pour configurer votre identifiants:

Ajouter l'assistant d'identification Go à votre GONOPROXY

  export GONOPROXY=github.com/GoogleCloudPlatform/artifact-registry-go-tools

Exécutez la commande suivante pour ajouter vos identifiants Artifact Registry à votre netrc à l'aide de l'outil de package du module Go:
```
  GOPROXY=proxy.golang.org \
      go run github.com/GoogleCloudPlatform/artifact-registry-go-tools/cmd/auth@v0.1.0 \
      add-locations --locations=LOCATION \
      [--json_key=path/to/service/account/key.json]
```
Où LOCATION correspond à la région lieu de votre dépôt. Pour ajouter plusieurs zones géographiques, saisissez-les par une virgule liste séparée.

L'assistant d'identification Go ajoute des paramètres à votre fichier netrc pour l'authentification à Artifact Registry. Si vous transmettez l'option --json_key, la clé est ajoutée à votre fichier netrc pour l'authentification par mot de passe.

Utiliser votre module en tant que dépendance

Si vous utilisez des identifiants éphémères pour l'authentification à Artifact Registry, vous devez actualiser votre jeton OAuth en exécutant la commande suivante:
```
  GOPROXY=proxy.golang.org \
  go run github.com/GoogleCloudPlatform/artifact-registry-go-tools/cmd/auth@v0.1.0 refresh
```
Dans votre répertoire d'accueil, créez un répertoire nommé "bar"
```
  mkdir bar
```
Changez de répertoire dans le répertoire de votre module et exécutez go mod init pour créer un fichier go.mod pour votre package.
```
  cd bar \
  go mod init example.com/bar
```
Remplacez example.com/bar par le chemin d'accès au module. Consultez le Documentation de référence sur les modules Go pour en savoir plus.
Pour exiger que la version de foo soit stockée dans Artifact Registry, modifiez votre go.mod, qui doit se présenter comme suit:
```
module example.com/bar

go 1.19

require example.com/foo v0.1.0
```
Remplacez les éléments suivants :
- example.com/foo est le chemin d'accès du module requis.
- v0.1.0 est la version stockée dans Artifact Registry

Créez un fichier main.go dans votre répertoire bar avec ce qui suit : contenus:

  
  package main

  import (
    "fmt"

    foo "example.com/foo"
  )

  func main() {
    fmt.Println(foo.HelloWorld)
  }

Exécutez go mod tidy pour télécharger les dépendances, y compris le paquet foo:
```
  go mod tidy
```
Exécutez le module "bar" :
```
  go run .
```
Le résultat se présente comme suit :
```
  Hello World!
```

Effectuer un nettoyage

Pour éviter que les ressources utilisées sur cette page soient facturées sur votre compte Google Cloud, procédez comme suit :

Pour éviter que les ressources utilisées sur cette page ne soient facturées sur votre compte Google Cloud, procédez comme suit : Avant de supprimer le dépôt, assurez-vous que les modules que vous souhaitez conserver sont disponibles ailleurs.

Pour supprimer le dépôt :
```
  gcloud artifacts repositories delete \
      --location=LOCATION \
      --project=PROJECT \
      REPOSITORY
```
Remplacez les éléments suivants :
- LOCATION avec l'emplacement régional ou multirégional lieu du dépôt.
- PROJECT par l'ID de votre projet Google Cloud.
- REPOSITORY par le nom du dépôt.
Si vous souhaitez supprimer les paramètres de dépôt et d'emplacement par défaut que vous configuré pour la configuration gcloud active, exécutez les commandes suivantes:
```
  gcloud config unset artifacts/repository
  gcloud config unset artifacts/location
```

Étape suivante

En savoir plus sur la configuration de l'authentification
Apprenez-en plus sur la gestion des dépôts.
Découvrez comment gérer les modules Go.
Consultez nos ressources sur le DevOps et explorez les programme de recherche DevOps Research and Assessment.

Stocker des modules Go dans Artifact Registry

Avant de commencer

Créer un dépôt

Définir des valeurs par défaut pour les commandes gcloud

Empaqueter et importer un module Go

Créer un module Go

Empaqueter et importer le module

Répertorier les modules

Afficher les détails de la version du module

Télécharger des modules

Configurer l'environnement Go

S'authentifier dans Artifact Registry

Ajouter l'assistant d'identification Go à GONOPROXY

Utiliser votre module en tant que dépendance

Effectuer un nettoyage

Étape suivante

Ajouter l'assistant d'identification Go à `GONOPROXY`