Configuration avec AWS Proton

Si vous souhaitez utiliser les AWS Proton API AWS CLI pour exécuter, vérifiez que vous les avez installées. Si vous ne l'avez pas installé, consultezConfiguration du AWS CLI.

AWS Proton configuration spécifique :

• Pour créer et gérer des modèles :

  • Si vous utilisez des configurations de synchronisation de modèles, configurez une AWS CodeStar connexion.

  • Sinon, configurez un compartiment Amazon S3.

• Pour approvisionner l'infrastructure :

  • Pour un provisionnement autogéré, vous devez configurer une AWS CodeStar connexion.

• (Facultatif) Pour approvisionner des pipelines :

  • Pour le provisionnement AWS géré et le provisionnement CodeBuildbasé, configurez les rôles du pipeline.

  • Pour un provisionnement autogéré, configurez un référentiel de pipelines.

Pour plus d'informations sur les méthodes de provisionnement, consultezComment fonctionne AWS le provisionnement géré.

Configuration d'un compartiment Amazon S3

Pour configurer un compartiment S3, suivez les instructions de la section Créez votre premier compartiment S3 pour configurer un compartiment S3. Placez vos entrées AWS Proton dans le compartiment où AWS Proton vous pourrez les récupérer. Ces entrées sont appelées ensembles de modèles. Vous pouvez en apprendre davantage à leur sujet dans d'autres sections de ce guide.

Configuration d'une AWS CodeStar connexion

Pour vous connecter AWS Proton à un référentiel, vous créez une AWS CodeStar connexion qui active un pipeline lorsqu'un nouveau commit est effectué sur un référentiel de code source tiers.

AWS Proton utilise la connexion pour :

• Activez un pipeline de services lorsqu'un nouveau commit est effectué sur le code source de votre référentiel.

• Effectuez une pull request sur une infrastructure en tant que référentiel de code.

• Créez une nouvelle version mineure ou majeure du modèle chaque fois qu'un commit est envoyé vers un référentiel de modèles qui modifie l'un de vos modèles, si la version n'existe pas déjà.

Vous pouvez vous connecter aux référentiels Bitbucket GitHub, GitHub Enterprise et GitHub Enterprise Server avec. CodeConnections Pour plus d'informations, consultez CodeConnectionsle guide de AWS CodePipeline l'utilisateur.

Pour configurer une CodeStar connexion.

1. Ouvrez la AWS Proton console.

2. Dans le volet de navigation, sélectionnez Paramètres, puis Connexions au référentiel pour accéder à la page Connexions dans les paramètres des outils de développement. La page affiche la liste des connexions.

3. Choisissez Créer une connexion et suivez les instructions.

Configuration des paramètres du pipeline CI/CD du compte

AWS Proton peut fournir des pipelines CI/CD pour déployer du code d'application dans vos instances de service. Les AWS Proton paramètres dont vous avez besoin pour le provisionnement du pipeline dépendent de la méthode de provisionnement que vous avez choisie pour votre pipeline.

AWS-provisionnement géré et CodeBuild basé : configuration des rôles de pipeline

Avec le provisionnement et le provisionnement AWS gérés, CodeBuild AWS Proton provisionnez les pipelines pour vous. Par conséquent, AWS Proton nécessite un rôle de service fournissant des autorisations pour le provisionnement des pipelines. Chacune de ces deux méthodes de provisionnement utilise son propre rôle de service. Ces rôles sont partagés entre tous les pipelines de AWS Proton services et vous ne les configurez qu'une seule fois dans les paramètres de votre compte.

Pour créer des rôles de service de pipeline à l'aide de la console

1. Ouvrez la AWS Proton console.

2. Dans le volet de navigation, choisissez Paramètres, puis Paramètres du compte.

3. Sur la page des paramètres CI/CD du compte, choisissez Configurer.

4. Effectuez l’une des actions suivantes :

   • Pour avoir AWS Proton créé un rôle de service de pipeline pour vous

     [Pour activer le provisionnement AWS géré des pipelines] Sur la page Configurer les paramètres du compte, dans la section du rôle du pipeline de provisionnement AWS géré :

     1. Sélectionnez Nouveau rôle de service.

     2. Entrez un nom pour le rôle, par exemple,myProtonPipelineServiceRole.

     3. Cochez la case pour accepter de créer un AWS Proton rôle doté de privilèges administratifs dans votre compte.

     [Pour activer le provisionnement CodeBuild basé sur les pipelines] Sur la page Configurer les paramètres du compte, dans la section Rôle de CodeBuild pipeline, choisissez Rôle de service existant, puis choisissez le rôle de service que vous avez créé dans la section Rôle de CloudFormation pipeline. Ou, si vous n'avez attribué aucun rôle de CloudFormation pipeline, répétez les trois étapes précédentes pour créer un nouveau rôle de service.

   • Pour choisir les rôles de service de pipeline existants

     [Pour activer le provisionnement AWS géré des pipelines] Sur la page Configurer les paramètres du compte, dans la section rôle du pipeline de provisionnement AWS géré, choisissez Rôle de service existant, puis choisissez un rôle de service dans votre compte. AWS

     [Pour activer le CodeBuild provisionnement des pipelines] Sur la page Configurer les paramètres du compte, dans la section Rôle de provisionnement du CodeBuild pipeline, choisissez Rôle de service existant, puis choisissez un rôle de service dans votre AWS compte.

5. Sélectionnez Enregistrer les modifications.

   Votre nouveau rôle de service de pipeline est affiché sur la page des paramètres du compte.

Approvisionnement autogéré : configurez un référentiel de pipelines

Avec le provisionnement autogéré, AWS Proton envoie une pull request (PR) à un référentiel de provisionnement que vous avez configuré, et votre code d'automatisation est responsable du provisionnement des pipelines. Par conséquent, AWS Proton il n'a pas besoin d'un rôle de service pour approvisionner des pipelines. Il a plutôt besoin d'un référentiel de provisioning enregistré. Votre code d'automatisation dans le référentiel doit assumer un rôle approprié qui fournit des autorisations pour le provisionnement des pipelines.

Pour enregistrer un référentiel de provisionnement de pipelines à l'aide de la console

1. Créez un référentiel de provisionnement du pipeline CI/CD si vous n'en avez pas encore créé un. Pour plus d'informations sur les pipelines dans le cadre du provisionnement autogéré, consultez. Comment fonctionne l'

2. Dans le volet de navigation, choisissez Paramètres, puis Paramètres du compte.

3. Sur la page des paramètres CI/CD du compte, choisissez Configurer.

4. Sur la page Configurer les paramètres du compte, dans la section du référentiel du pipeline CI/CD :

   1. Sélectionnez Nouveau référentiel, puis choisissez l'un des fournisseurs de référentiels.

   2. Pour la CodeStar connexion, choisissez l'une de vos connexions.

      Note

      Si vous n'êtes pas encore connecté au compte du fournisseur de référentiel concerné, choisissez Ajouter une nouvelle CodeStar connexion, terminez le processus de création de connexion, puis cliquez sur le bouton d'actualisation situé à côté du menu de CodeStarconnexion. Vous devriez maintenant pouvoir choisir votre nouvelle connexion dans le menu.

   3. Dans Nom du référentiel, choisissez le référentiel de provisionnement de votre pipeline. Le menu déroulant affiche la liste des référentiels du compte fournisseur.

   4. Dans Nom de la branche, choisissez l'une des branches du référentiel.

5. Sélectionnez Enregistrer les modifications.

   Le référentiel de votre pipeline est affiché sur la page des paramètres du compte.

Configuration du AWS CLI

Pour utiliser le AWS CLI pour effectuer des appels d' AWS Proton API, vérifiez que vous avez installé la dernière version du AWS CLI. Pour plus d’informations, consultez Mise en route avec le AWS CLI dans le AWS Command Line Interface Guide de l’utilisateur. Ensuite, pour commencer à utiliser le AWS CLI with AWS Proton, voirDémarrer avec le kit AWS CLI.