Création d'un pipeline utilisant CodeBuild (AWS CLI)

Créez ou identifiez un projet de génération dans CodeBuild. Pour plus d'informations, veuillez consulter Création d'un projet de génération.

Assurez-vous d'avoir configuré leAWS CLI avec la cléAWS d'accès et la clé d'accèsAWS secrète qui correspondent à l'une des entités IAM décrites dans cette rubrique. Pour de plus amples informations, veuillez consulter Préparation de l'installation de l'AWS Command Line Interface dans le Guide de l'utilisateur AWS Command Line Interface.

Créez un fichier au format JSON représentant la structure du pipeline. Nommez le fichier create-pipeline.json ou avec un nom similaire. Par exemple, cette structure au format JSON crée un pipeline avec une action source qui référence un compartiment d'entrée S3 et une action de génération utilisant CodeBuild :

{
  "pipeline": {
    "roleArn": "arn:aws:iam::<account-id>:role/<AWS-CodePipeline-service-role-name>",
    "stages": [
      {
        "name": "Source",
        "actions": [
          {
            "inputArtifacts": [],
            "name": "Source",
            "actionTypeId": {
              "category": "Source",
              "owner": "AWS",
              "version": "1",
              "provider": "S3"
            },
            "outputArtifacts": [
              {
                "name": "MyApp"
              }
            ],
            "configuration": {
              "S3Bucket": "<bucket-name>",
              "S3ObjectKey": "<source-code-file-name.zip>"
            },
            "runOrder": 1
          }
        ]
      },
      {
        "name": "Build",
        "actions": [
          {
            "inputArtifacts": [
              {
                "name": "MyApp"
              }
            ],
            "name": "Build",
            "actionTypeId": {
              "category": "Build",
              "owner": "AWS",
              "version": "1",
              "provider": "CodeBuild"
            },
            "outputArtifacts": [
              {
                "name": "default"
              }
            ],
            "configuration": {
              "ProjectName": "<build-project-name>"
            },
            "runOrder": 1
          }
        ]
      }
    ],
    "artifactStore": {
      "type": "S3",
      "location": "<CodePipeline-internal-bucket-name>"
    },
    "name": "<my-pipeline-name>",
    "version": 1
  }
}

Dans ces données au format JSON :

Même si ces données décrivent uniquement une action source et une action de génération, vous pouvez ajouter des actions pour les activités liées au test, au déploiement de l'artefact de sortie de génération, à l'appel des fonctions AWS Lambda, etc. Pour de plus amples informations, veuillez consulter Référence sur la structure du pipeline AWS CodePipeline dans le Guide de l'utilisateur AWS CodePipeline.

Placez-vous dans le dossier qui contient le fichier JSON, puis exécutez la commande CodePipeline create-pipeline en spécifiant le nom de fichier :

aws codepipeline create-pipeline --cli-input-json file://create-pipeline.json

Les données au format JSON s'affichent dans la sortie, et CodePipeline crée le pipeline.

Pour obtenir des informations sur l'état du pipeline, exécutez la commande CodePipeline get-pipeline-state en spécifiant le nom du pipeline :

aws codepipeline get-pipeline-state --name <my-pipeline-name>

Dans la sortie, recherchez les informations qui confirment que la génération a réussi. Des ellipses (...) sont utilisées pour les données qui ont été omises par souci de concision.

{
  ...
  "stageStates": [
    ...  
    {
      "actionStates": [
        {
          "actionName": "CodeBuild",
          "latestExecution": {
            "status": "SUCCEEDED",
            ...
          },
          ...
        }
      ]
    }
  ]
}

Si vous exécutez cette commande trop tôt, vous risquez de ne voir aucune information sur l'action de génération. Vous devrez peut-être exécuter cette commande plusieurs fois jusqu'à ce que le pipeline ait fini d'exécuter l'action de génération.

Après une génération réussie, suivez ces instructions pour obtenir l'artefact de sortie de la génération. Ouvrez la console Amazon S3 sur https://console.aws.amazon.com/s3/.

Dans la liste des compartiments, ouvrez le compartiment utilisé par le pipeline. Le nom du compartiment doit suivre le format codepipeline-<region-ID>-<random-number>. Vous pouvez obtenir le nom du compartiment à partir du fichier create-pipeline.json ou en exécutant la commande CodePipeline get-pipeline.

aws codepipeline get-pipeline --name <pipeline-name>

Dans la sortie, l'objet pipeline contient un objet artifactStore contenant une valeur location avec le nom du compartiment.

Ouvrez le dossier correspondant au nom de votre pipeline (par exemple, <pipeline-name>).

Dans ce dossier, ouvrez le dossier nommé default (par défaut).

Extrayez le contenu du fichier . Si ce dossier contient plusieurs fichiers, extrayez le contenu du fichier avec le dernier horodatage Last Modified. (Vous pouvez attribuer au fichier une extension .zip pour pouvoir l'utiliser avec l'utilitaire ZIP de votre système.) L'artefact de sortie de génération figure dans le contenu extrait du fichier.