Générer et tester des projets Go

Azure DevOps Services

Utilisez un pipeline pour générer et tester automatiquement vos projets Go.

Créer votre premier pipeline

Vous débutez avec Azure Pipelines ? Si c’est le cas, nous vous recommandons de consulter cette section avant de passer à d’autres sections.

Effectuez une duplication (fork) du dépôt suivant sur GitHub :

https://github.com/MicrosoftDocs/pipelines-go

Se connecter à Azure Pipelines

Connectez-vous à Azure Pipelines. Une fois que vous êtes connecté, votre navigateur accède à https://dev.azure.com/my-organization-name et affiche votre tableau de bord Azure DevOps.

1. Dans un navigateur, rendez-vous sur dev.azure.com et connectez-vous.
2. Sélectionnez votre organisation.
3. Créez un nouveau projet en sélectionnant Nouveau projet ou Créer un projet si c’est le premier projet dans l’organisation.
4. Entrez un Nom de projet.
5. Choisissez la Visibilité de votre projet.
6. Sélectionnez Créer.

1. Dans un navigateur, rendez-vous sur votre serveur Azure DevOps.
2. Sélectionnez votre collection.
3. Créez un nouveau projet en sélectionnant Nouveau projet ou Créer un projet si c’est le premier projet dans la collection.
4. Entrez un Nom de projet.
5. Choisissez la Visibilité de votre projet.
6. Sélectionnez Créer.

Créer le pipeline

1. Connectez-vous à votre organisation Azure DevOps et accédez à votre projet.

2. Accédez à Pipelines, puis sélectionnez Nouveau pipeline ou Création d’un pipeline si vous créez votre premier pipeline.

3. Effectuez les étapes de l’Assistant en sélectionnant d’abord GitHub comme emplacement du code source.

4. Vous serez peut-être redirigé vers GitHub pour vous connecter. Si c’est le cas, entrez vos informations d’identification GitHub.

5. Quand la liste des dépôts s’affiche, sélectionnez le vôtre.

6. Vous serez peut-être redirigé vers GitHub pour pouvoir installer l’application Azure Pipelines. Si c’est le cas, sélectionnez Approuver et installer.

Lorsque l’onglet Configurer s’affiche, sélectionnez Go. Votre nouveau pipeline s’affiche, avec le fichier YAML azure-pipelines.yml prêt à être configuré. Consultez les sections suivantes pour découvrir quelques-unes des méthodes les plus courantes pour personnaliser votre pipeline.

Environnement de génération

Vous pouvez utiliser Azure Pipelines pour créer vos projets Go sans configurer votre propre infrastructure. Vous pouvez utiliser des agents Linux, macOS ou Windows pour exécuter vos builds.

Mettez à jour l’extrait de code suivant dans votre fichier azure-pipelines.yml pour sélectionner l’image appropriée.

pool:
  vmImage: 'ubuntu-latest'

Les versions modernes de Go sont préinstallées sur les agents hébergés par Microsoft. Pour connaître les versions exactes de Go préinstallées, reportez-vous à Agents hébergés par Microsoft dans Azure Pipelines.

Configurer Go

Go 1.11+

À compter de Go 1.11, vous n’avez plus besoin de définir un environnement $GOPATH, de configurer un layout d’espace de travail ou d’utiliser le module dep. La gestion des dépendances est désormais intégrée.

Ce YAML implémente la commande go get pour télécharger les packages Go et leurs dépendances. Il utilise ensuite go build pour générer le contenu publié avec la tâche PublishBuildArtifacts@1.

trigger: 
 - main

pool:
   vmImage: 'ubuntu-latest'

steps: 
- task: GoTool@0
  inputs:
    version: '1.13.5'
- task: Go@0
  inputs:
    command: 'get'
    arguments: '-d'
    workingDirectory: '$(System.DefaultWorkingDirectory)'
- task: Go@0
  inputs:
    command: 'build'
    workingDirectory: '$(System.DefaultWorkingDirectory)'
- task: CopyFiles@2
  inputs:
    TargetFolder: '$(Build.ArtifactStagingDirectory)'
- task: PublishBuildArtifacts@1
  inputs:
     artifactName: drop

Go < 1.11

Comme décrit dans la documentation Go, un espace de travail Go se compose d’un répertoire racine vers lequel la variable d’environnement $GOPATH pointe. Dans ce répertoire, voici les sous-répertoires standard :

• bin pour contenir des commandes exécutables
• pkg pour contenir des packages compilés (fichiers .a)
• src pour contenir des fichiers sources Go (.go, .c, .g, .s)

Lorsqu’une build Azure Pipelines récupère du code à partir d’un référentiel distant, il place le code dans le répertoire de travail par défaut de la build. Pour correspondre à la structure attendue d’un espace de travail Go, ajoutez l’extrait de code suivant à votre fichier azure-pipelines.yml. Ce script s’exécute dans bash sur des agents Linux et macOS, mais doit être modifié pour Windows.

variables:
  GOBIN:  '$(GOPATH)/bin' # Go binaries path
  GOPATH: '$(system.defaultWorkingDirectory)/gopath' # Go workspace path
  modulePath: '$(GOPATH)/src/github.com/$(build.repository.name)' # Path to the module's code

steps:
- script: |
    mkdir -p '$(GOBIN)'
    mkdir -p '$(GOPATH)/pkg'
    mkdir -p '$(modulePath)'
    shopt -s extglob
    shopt -s dotglob
    mv !(gopath) '$(modulePath)'
    echo '##vso[task.prependpath]$(GOBIN)'
  displayName: 'Set up the Go workspace'

- script: |
    go version
    go get -v -t -d ./...
    if [ -f Gopkg.toml ]; then
        curl https://raw.githubusercontent.com/golang/dep/master/install.sh | sh
        dep ensure
    fi
    go build -v .
  workingDirectory: '$(modulePath)'
  displayName: 'Get dependencies, then build'

Si votre code n’est pas sur GitHub, remplacez l’utilisation de github.com par la variable modulePath par une valeur appropriée pour votre module.

Cet extrait de code exécute les actions suivantes :

1. Définit $GOROOT sur la version de Go qui doit être utilisée.
2. Définit d’autres variables d’environnement Go connues sur leurs valeurs appropriées.
3. Crée un espace de travail Go dans un sous-répertoire nommé gopath avec des répertoires enfants bin, pkg et src.
4. Déplace le code récupéré dans le référentiel distant dans le répertoire de l’espace de travail src.
5. Ajoute la version de Go et le répertoire bin de l’espace de travail au chemin d’accès.

Installer des dépendances

Utiliser go get

Utilisez go get pour télécharger le code source d’un projet Go ou pour installer un outil dans l’espace de travail Go. Ajoutez l’extrait de code suivant à votre fichier azure-pipelines.yml :

- script: go get -v -t -d ./...
  workingDirectory: '$(modulePath)'
  displayName: 'go get dependencies'

Utiliser dep ensure

Utilisez dep ensure si votre projet utilise dep pour télécharger les dépendances importées dans votre code. L’exécution de dep ensure clone les référentiels importés dans le répertoire fournisseur de votre projet. Ses fichiers Gopkg.lock et Gopkg.toml garantissent que tout le monde travaillant sur le projet utilise la même version de dépendances que votre build. Ajoutez l’extrait de code suivant à votre fichier azure-pipelines.yml.

Notes

Le script suivant s’exécute sur des agents Linux et macOS et peut être utilisé pour les versions antérieures de Go qui nécessitent une structure de dossiers spécifique. Le script est écrit pour les interpréteurs de commandes Unix et, par conséquent, ne peut pas fonctionner avec les agents Windows.

- script: |
    if [ -f Gopkg.toml ]; then
        curl https://raw.githubusercontent.com/golang/dep/master/install.sh | sh
        dep ensure
    fi
  workingDirectory: '$(modulePath)'
  displayName: 'Download dep and run `dep ensure`'

Build

Utilisez go build pour générer votre projet Go. Ajoutez l’extrait de code suivant à votre fichier azure-pipelines.yml :

- task: Go@0
  inputs:
    command: 'build'
    workingDirectory: '$(System.DefaultWorkingDirectory)'

Test

Utilisez go test pour tester votre module Go et ses sous-répertoires (./...). Ajoutez l’extrait de code suivant à votre fichier azure-pipelines.yml :

- task: Go@0
  inputs:
    command: 'test'
    arguments: '-v'
    workingDirectory: '$(System.DefaultWorkingDirectory)'

Lorsque vous êtes prêt, validez un nouveau fichier azure-pipelines.yml dans votre référentiel et mettez à jour le message de validation. Sélectionnez Enregistrer et exécuter.

Si vous souhaitez surveiller votre pipeline en action, sélectionnez la build dans l’option Travaux de votre tableau de bord Azure Pipelines.

Étant donné que votre code semblait correspondre au modèle Go, nous avons automatiquement créé votre pipeline.

Vous disposez maintenant d’un pipeline YAML opérationnel (azure-pipelines.yml) dans votre référentiel qui est prêt à être personnalisé !

Lorsque vous êtes prêt à apporter des modifications à votre pipeline, sélectionnez-le dans la page Pipelines, puis Modifiez le fichier azure-pipelines.yml.

Conseil

Pour apporter des modifications au fichier YAML comme décrit dans cet article, sélectionnez le pipeline dans la page Pipelines, puis sélectionnez Modifier pour ouvrir un éditeur pour le fichier azure-pipelines.yml.

Générer et envoyer une image au registre de conteneurs

Pour votre application Go, vous pouvez également générer une image et l’envoyer à un registre de conteneurs.

Extensions associées

Extension Go pour Visual Studio Code (Microsoft)