Tutoriel : Création d'un pipeline utilisant Amazon S3 comme fournisseur de déploiement

Pour transférer des fichiers vers votre CodeCommit dépôt

1. Extrayez les exemples de fichier téléchargés. Ne chargez pas le ZIP fichier dans votre dépôt.

2. Envoyez ou téléchargez les fichiers dans votre CodeCommit dépôt. Ces fichiers sont l'artefact source créé par l'assistant de création de pipeline pour votre action de déploiement dans CodePipeline. Vos fichiers doivent être similaires à ce qui suit dans votre répertoire local :

   index.html
   main.css
   graphic.jpg

3. Vous pouvez utiliser Git ou la CodeCommit console pour télécharger vos fichiers :

   1. Pour utiliser la ligne de commande Git à partir d'un référentiel cloné sur votre ordinateur local :

      1. Exécutez la commande suivante pour organiser tous vos fichiers à la fois :

         git add -A

      2. Exécutez la commande suivante pour valider les fichiers avec un message de validation :

         git commit -m "Added static website files"

      3. Exécutez la commande suivante pour transférer les fichiers de votre dépôt local vers votre CodeCommit dépôt :

         git push

   2. Pour télécharger vos fichiers à l' CodeCommit aide de la console, procédez comme suit :

      1. Ouvrez la CodeCommit console et choisissez votre dépôt dans la liste des référentiels.

      2. Choisissez Ajouter un fichier, puis choisissez Charger le fichier.

      3. Sélectionnez Choose file (Choisir un fichier), puis naviguez vers votre fichier. Validez la modification en entrant votre nom d'utilisateur et votre adresse e-mail. Choisissez Valider les modifications.

      4. Répétez cette étape pour chaque fichier que vous souhaitez charger.

Pour créer un pipeline avec l'assistant

1. Connectez-vous à la CodePipeline console AWS Management Console et ouvrez-la à l'adresse http://console.aws.amazon.com/codesuite/codepipeline/home.

2. Sur la page Bienvenue, Démarrez ou Pipelines, choisissez Créer un pipeline.

3. Dans l'Étape 1 : Choisir les paramètres d'un pipeline, dans Nom du pipeline, saisissez MyS3DeployPipeline.

4. Dans Type de pipeline, choisissez V2. Pour de plus amples informations, veuillez consulter Types de canalisations. Choisissez Suivant.

5. Dans Rôle de service, choisissez Nouveau rôle de service CodePipeline pour autoriser la création d'un rôle de service dansIAM.

6. Laissez les paramètres sous Advanced settings (Paramètres avancés) à leurs valeurs par défaut, puis choisissez Suivant.

7. Dans Étape 2 : Ajouter une étape source, dans Fournisseur de source, choisissez AWS CodeCommit. Dans Nom du référentiel, choisissez le nom du CodeCommit référentiel dans lequel vous l'avez crééÉtape 1 : Création d'un CodeCommit référentiel. Dans Nom de branche, choisissez le nom de la branche qui contient votre dernière mise à jour du code. À moins d'avoir créé une autre branche vous-même, seul main est disponible.

   Après avoir sélectionné le nom du référentiel et la branche, la règle Amazon CloudWatch Events à créer pour ce pipeline s'affiche.

   Choisissez Suivant.

8. Dans Step 3: Add build stage (Étape 3 : Ajouter une étape de génération), choisissez Skip build stage (Ignorer l'étape de génération) et acceptez le message d'avertissement en choisissant à nouveau Skip (Ignorer).

   Choisissez Suivant.

9. Dans Étape 4 : Ajouter une étape de déploiement :

   1. Dans Deploy provider (Fournisseur de déploiement), choisissez Amazon S3.

   2. Dans Bucket (Compartiment), indiquez le nom du compartiment public.

   3. Sélectionnez Extract file before deploy (Extraire le fichier avant de déployer).

      Note

      Le déploiement échoue si vous ne sélectionnez pas Veuillez extraire le fichier avant le déploiement. Cela est dû au fait que l' AWS CodeCommit action de votre pipeline compresse les artefacts source et que votre fichier est un ZIP fichier.

      Lorsque Extract file before deploy (Extraire le fichier avant de déployer) est sélectionné, Deployment path (Chemin de déploiement) s'affiche. Entrez le nom du chemin que vous souhaitez utiliser. Cela crée une structure de dossiers dans Amazon S3 dans laquelle les fichiers sont extraits. Dans le cadre de ce didacticiel, laissez ce champ vide.

      

   4. (Facultatif) Dans Canned ACL, vous pouvez appliquer un ensemble d'autorisations prédéfinies, appelées autorisations prédéfiniesACL, aux artefacts téléchargés.

   5. (Facultatif) Dans Cache control (Contrôle de cache), entrez les paramètres de mise en cache. Vous pouvez définir cela pour contrôler le comportement de mise en cache pour les demandes/réponses. Pour les valeurs valides, consultez le champ Cache-Controld'en-tête pour les HTTP opérations.

   6. Choisissez Suivant.

10. Dans Step 5: Review, vérifiez les informations puis choisissez Create pipeline.

11. Une fois votre pipeline exécuté avec succès, ouvrez la console Amazon S3 et vérifiez que vos fichiers apparaissent dans votre compartiment public, comme indiqué :

    index.html
    main.css
    graphic.jpg

12. Accédez à votre point de terminaison pour tester le site web. Votre point de terminaison est conforme au format suivant : http://bucket-name.s3-website-region.amazonaws.com/.

    Exemple de point de terminaison : http://my-bucket.s3-website-us-west-2.amazonaws.com/.

    L'exemple de page Web apparaît.

Pour créer un fichier buildspec.yml

• Créez un fichier nommé buildspec.yml avec les contenus suivants. Ces commandes de compilation installent TypeScript et utilisent le TypeScript compilateur pour réécrire le code index.ts en JavaScript code.

  version: 0.2
  
  phases:
    install:
      commands:
        - npm install -g typescript
    build:
      commands:
        - tsc index.ts
  artifacts:
    files:
      - index.js

Pour créer un fichier index.ts

• Créez un fichier nommé index.ts avec les contenus suivants.

  interface Greeting {
      message: string;
  }
  
  class HelloGreeting implements Greeting {
      message = "Hello!";
  }
  
  function greet(greeting: Greeting) {
      console.log(greeting.message);
  }
  
  let greeting = new HelloGreeting();
  
  greet(greeting);

Pour charger des fichiers sur votre compartiment source S3

1. Vos fichiers doivent être similaires à ce qui suit dans votre répertoire local :

   buildspec.yml
   index.ts

   Compressez les fichiers et nommez le fichier source.zip.

2. Dans la console Amazon S3, pour votre compartiment source, choisissez Upload. Choisissez Ajouter des fichiers, puis recherchez le ZIP fichier que vous avez créé.

3. Sélectionnez Charger. Ces fichiers sont l'artefact source créé par l'assistant de création de pipeline pour votre action de déploiement dans CodePipeline. Votre fichier doit être similaire à ce qui suit dans votre compartiment :

   source.zip

Pour créer un pipeline avec l'assistant

1. Connectez-vous à la CodePipeline console AWS Management Console et ouvrez-la à l'adresse http://console.aws.amazon.com/codesuite/codepipeline/home.

2. Sur la page Bienvenue, Démarrez ou Pipelines, choisissez Créer un pipeline.

3. Dans l'Étape 1 : Choisir les paramètres d'un pipeline, dans Nom du pipeline, saisissez MyS3DeployPipeline.

4. Dans Rôle de service, choisissez Nouveau rôle de service CodePipeline pour autoriser la création d'un rôle de service dansIAM.

5. Laissez les paramètres sous Advanced settings (Paramètres avancés) à leurs valeurs par défaut, puis choisissez Suivant.

6. Dans Step 2: Add source stage (Étape 2 : Ajouter une étape source), dans Source provider (Fournisseur source), choisissez Amazon S3. Dans Bucket (Compartiment), choisissez le nom de votre compartiment source. Dans la clé d'objet S3, entrez le nom de votre ZIP fichier source. Assurez-vous d'inclure l'extension de fichier .zip.

   Choisissez Suivant.

7. Dans Step 3: Add build stage (Étape 3 : Ajouter une étape de génération) :

   1. Dans le champ Fournisseur de génération, choisissez CodeBuild.

   2. Choisissez Créer un projet de génération. Sur la page Create project (Créer un projet) :

   3. Dans Nom du projet, saisissez un nom pour ce projet de génération.

   4. Dans Environnement, choisissez Image gérée. Pour Système d'exploitation, choisissez Ubuntu.

   5. Pour Runtime (Exécution), sélectionnez Standard. Pour Version d'exécution, choisissez aws/codebuild/standard:1.0.

   6. Dans Version d'image, choisissez Utilisez Always use the latest image for this runtime version (Toujours utiliser la dernière image pour cette version d'exécution).

   7. Pour Rôle de service, choisissez votre rôle CodeBuild de service ou créez-en un.

   8. Pour Build specifications (Spécifications de génération), choisissez Use a buildspec file (Utiliser un fichier buildspec).

   9. Choisissez Continuer vers CodePipeline. Un message s'affiche si le projet est créé avec succès.

   10. Choisissez Suivant.

8. Dans Étape 4 : Ajouter une étape de déploiement :

   1. Dans Deploy provider (Fournisseur de déploiement), choisissez Amazon S3.

   2. Dans Bucket (Compartiment), entrez le nom de votre compartiment cible S3.

   3. Assurez-vous que Extract file before deploy (Extraire le fichier avant de déployer) est décochée.

      Lorsque Extract file before deploy (Extraire le fichier avant de déployer) est décochée, S3 object key (Clé d'objet S3) est affiché. Entrez le nom du chemin que vous souhaitez utiliser : js-application/{datetime}.zip.

      Cela crée un js-application dossier dans Amazon S3 dans lequel les fichiers sont extraits. Dans ce dossier, la variable {datetime} crée un horodatage sur chaque fichier de sortie lorsque votre pipeline s'exécute.

      

   4. (Facultatif) Dans Canned ACL, vous pouvez appliquer un ensemble d'autorisations prédéfinies, appelées autorisations prédéfiniesACL, aux artefacts téléchargés.

   5. (Facultatif) Dans Cache control (Contrôle de cache), entrez les paramètres de mise en cache. Vous pouvez définir cela pour contrôler le comportement de mise en cache pour les demandes/réponses. Pour les valeurs valides, consultez le champ Cache-Controld'en-tête pour les HTTP opérations.

   6. Choisissez Suivant.

9. Dans Step 5: Review, vérifiez les informations puis choisissez Create pipeline.

10. Une fois votre pipeline exécuté avec succès, consultez votre compartiment dans la console Amazon S3. Vérifiez que ZIP le fichier déployé est affiché dans votre compartiment cible sous le js-application dossier. Le JavaScript fichier contenu dans le ZIP fichier doit êtreindex.js. Le fichier index.js contient la sortie suivante :

    var HelloGreeting = /** @class */ (function () {
        function HelloGreeting() {
            this.message = "Hello!";
        }
        return HelloGreeting;
    }());
    function greet(greeting) {
        console.log(greeting.message);
    }
    var greeting = new HelloGreeting();
    greet(greeting);