Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Personnaliser le compte

L'AFT peut déployer des configurations standard ou personnalisées dans des comptes provisionnés. Dans le compte de gestion de l'AFT, l'AFT fournit un pipeline pour chaque compte. Grâce à ce pipeline, vous pouvez implémenter vos personnalisations dans tous les comptes, dans un ensemble de comptes ou dans des comptes individuels. Vous pouvez exécuter des scripts Python, des scripts bash et des configurations Terraform, ou vous pouvez interagir avec l'AWS CLI dans le cadre de la phase de personnalisation de votre compte.

Vue d’ensemble

Une fois que vos personnalisations sont spécifiées dans les git référentiels que vous avez choisis, que ce soit celui où vous stockez vos personnalisations globales ou celui où vous stockez les personnalisations de votre compte, l'étape de personnalisation du compte est automatiquement terminée par le pipeline AFT. Pour personnaliser les comptes de manière rétroactive, consultezRe-invoke personnalisations.

Personnalisations globales (facultatif)

Vous pouvez choisir d'appliquer certaines personnalisations à tous les comptes provisionnés par l'AFT. Par exemple, si vous devez créer un rôle IAM particulier ou déployer un contrôle personnalisé dans chaque compte, l'étape de personnalisation globale du pipeline AFT vous permet de le faire automatiquement.

Personnalisation du compte (facultatif)

Pour personnaliser un compte individuel ou un ensemble de comptes différemment des autres comptes provisionnés par AFT, vous pouvez tirer parti de la partie du pipeline AFT consacrée aux personnalisations des comptes pour implémenter des configurations spécifiques au compte. Par exemple, seul un certain compte peut nécessiter l'accès à une passerelle Internet.

Prérequis de personnalisation

Avant de commencer à personnaliser les comptes, assurez-vous que ces prérequis sont en place.

Appliquer des personnalisations globales

Pour appliquer des personnalisations globales, vous devez envoyer une structure de dossiers spécifique vers le référentiel de votre choix.

Appliquer les personnalisations de compte

Vous pouvez personnaliser votre compte en transférant une structure de dossiers spécifique vers le référentiel de votre choix. Les personnalisations de compte sont appliquées automatiquement dans le pipeline AFT et après la phase de personnalisation globale. Vous pouvez également créer plusieurs dossiers contenant différentes personnalisations de compte dans votre référentiel de personnalisations de compte. Pour chaque personnalisation de compte dont vous avez besoin, procédez comme suit.

Re-invoke personnalisations

L'AFT permet de réinvoquer les personnalisations dans le pipeline AFT. Cette méthode est utile lorsque vous avez ajouté une nouvelle étape de personnalisation ou lorsque vous apportez des modifications à une personnalisation existante. Lorsque vous réinvoquez, AFT lance le pipeline de personnalisations pour apporter des modifications au compte provisionné par AFT. Une réinvocation basée sur la source des événements vous permet d'appliquer des personnalisations à des comptes individuels, à tous les comptes, à des comptes en fonction de leur unité organisationnelle ou à des comptes sélectionnés en fonction de balises.

Suivez ces trois étapes pour réactiver les personnalisations des comptes. AFT-provisioned

Étape 1 : Transférez les modifications aux référentiels globaux ou de personnalisation des git comptes

Vous pouvez mettre à jour vos personnalisations globales et celles de votre compte selon vos besoins et renvoyer les modifications à vos git référentiels. À ce stade, rien ne se passe. Le pipeline de personnalisations doit être invoqué par une source d'événements, comme expliqué dans les deux étapes suivantes.

Étape 2 : démarrer une exécution d'AWS Step Function pour réinvoquer les personnalisations

AFT fournit une fonction AWS Step appelée aft-invoke-customizations dans le compte de gestion AFT. Le but de cette fonction est de réinvoquer le pipeline de personnalisation pour AFT-provisioned les comptes.

Voici un exemple de schéma d'événement (format JSON) que vous pouvez créer pour transmettre des données à la fonction aft-invoke-customizations AWS Step.

{
  "include": [
    {
      "type": "all"
    },
    {
      "type": "ous",
      "target_value": [ "ou1","ou2"]
    },
    {
      "type": "tags",
      "target_value": [ {"key1": "value1"}, {"key2": "value2"}]
    },
    {
      "type": "accounts",
      "target_value": [ "acc1_ID","acc2_ID"]
    }
  ],

  "exclude": [
    {
      "type": "ous",
      "target_value": [ "ou1","ou2"]
    },
    {
      "type": "tags",
      "target_value": [ {"key1": "value1"}, {"key2": "value2"}]
    },
    {
      "type": "accounts",
      "target_value": [ "acc1_ID","acc2_ID"]
    }
  ]
}

L'exemple de schéma d'événements montre que vous pouvez choisir les comptes à inclure ou à exclure du processus de réinvocation. Vous pouvez filtrer par unité organisationnelle (OU), par étiquette de compte et par identifiant de compte. Si vous n'appliquez aucun filtre et n'incluez pas le relevé"type":"all", la personnalisation pour tous les AFT-provisioned comptes est réinvoquée.

Vous pouvez inclure un bypass_steps paramètre dans l'entrée Step Functions pour ignorer des phases de provisionnement spécifiques lors de la réinvocation.

L'exemple suivant montre une entrée Step Functions qui invoque à nouveau les personnalisations pour un compte spécifique tout en contournant les étapes de provisionnement et d'amorçage.

{
  "include": [
    {
      "type": "accounts",
      "target_value": ["123456789012"]
    }
  ],
  "bypass_steps": ["provisioning_bootstrap"]
}

Une fois que vous avez renseigné les paramètres de l'événement, Step Functions s'exécute et appelle les personnalisations correspondantes. AFT peut invoquer un maximum de 5 personnalisations à la fois. Step Functions attend et boucle jusqu'à ce que tous les comptes correspondant aux critères de l'événement soient terminés.

Étape 3 : Surveillez le résultat d'AWS Step Function et observez AWS CodePipeline en cours d'exécution

Résolution des problèmes liés au suivi des demandes de personnalisation des comptes AFT

Workflows de personnalisation des comptes basés sur des journaux AWS Lambda d'émission contenant des identifiants de compte cible et de demande de personnalisation. AFT vous permet de suivre et de résoudre les demandes de personnalisation avec Amazon CloudWatch Logs en vous fournissant des requêtes CloudWatch Logs Insights que vous pouvez utiliser pour filtrer les CloudWatch journaux liés à votre demande de personnalisation en fonction de votre compte cible ou de votre ID de demande de personnalisation. Pour plus d'informations, consultez la section Analyse des données de journal avec Amazon CloudWatch Logs dans le guide de l'utilisateur Amazon CloudWatch Logs.