

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.

# Profil d’instance des instances gérées Amazon ECS
<a name="managed-instances-instance-profile"></a>

Un profil d’instance est un conteneur IAM qui contient exactement un rôle IAM et permet aux instances gérées Amazon ECS d’assumer ce rôle en toute sécurité. Le profil d’instance contient un rôle d’instance que l’agent ECS assume pour enregistrer les instances auprès des clusters et communiquer avec le service ECS.

**Important**  
Si vous utilisez des instances gérées Amazon ECS avec `AmazonECSInfrastructureRolePolicyForManagedInstances` politique gérée, le nom du rôle d'instance doit commencer par `ecsInstanceRole`. Les champs d'application de la politique `iam:PassRole` pour `arn:aws:iam::*:role/ecsInstanceRole*`, donc un nom différent provoque une erreur d'autorisation lors du lancement de la tâche. Ceci est courant avec CloudFormation lorsque vous omettez `RoleName`, parce que CloudFormation génère automatiquement des noms tels que `MyStack-InstanceRole-ABC123`.  
Si vous utilisez plutôt une politique de rôle d'infrastructure personnalisée, le rôle d'instance peut avoir n'importe quel nom tant que votre stratégie inclut un `iam:PassRole` subvention ciblant l'ARN du rôle d'instance.

## Création d’un rôle avec la stratégie d’approbation
<a name="create-instance-role"></a>

Remplacez tout {{user input}} avec vos propres informations.

1. Créez un fichier nommé `ecsInstanceRole-trust-policy.json` contenant la stratégie d'approbation à utiliser pour le rôle IAM. Le fichier doit contenir ce qui suit :

------
#### [ JSON ]

****  

   ```
   {
     "Version":"2012-10-17",		 	 	 
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": { "Service": "ec2.amazonaws.com"},
         "Action": "sts:AssumeRole"
       }
     ]
   }
   ```

------

1. Utilisez ce qui suit AWS CLI commande pour créer un rôle nommé `ecsInstanceRole` en utilisant la politique de confiance que vous avez créée à l'étape précédente.

   ```
   aws iam create-role \
         --role-name ecsInstanceRole \
         --assume-role-policy-document file://{{ecsInstanceRole-trust-policy.json}}
   ```

1. Joignez le AWS géré `AmazonECSInstanceRolePolicyForManagedInstances` politique à l'égard de `ecsInstanceRole` rôle.

   ```
   aws iam attach-role-policy \
         --role-name ecsInstanceRole \
         --policy-arn arn:aws:iam::aws:policy/AmazonECSInstanceRolePolicyForManagedInstances
   ```
**Note**  
Si vous choisissez d'appliquer les autorisations de moindre privilège et de spécifier vos propres autorisations à la place, vous pouvez ajouter les autorisations suivantes pour vous aider à résoudre les problèmes liés aux tâches avec les instances gérées Amazon ECS :   
`ecs:StartTelemetrySession`
`ecs:PutSystemLogEvents`

Vous pouvez également utiliser le flux de travail **Stratégie d’approbation personnalisée** de la console IAM pour créer le rôle. Pour plus d’informations, reportez-vous à la section [Création d’un rôle à l’aide de politiques de confiance personnalisées (console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-custom.html) dans le *Guide de l’utilisateur IAM*.

Une fois le fichier créé, vous devez autoriser votre utilisateur à transmettre le rôle à Amazon ECS.

## Créez le profil d'instance à l'aide du AWS CLI
<a name="create-instance-profile"></a>

Après avoir créé le rôle, créez le profil d’instance à l’aide de l’ AWS CLI :

```
aws iam create-instance-profile --instance-profile-name ecsInstanceRole 
```

Ajoutez le rôle au profil d’instance :

```
aws iam add-role-to-instance-profile \
   --instance-profile-name ecsInstanceRole \
   --role-name ecsInstanceRole
```

Vérifiez que le profil a été créé avec succès :

```
aws iam get-instance-profile --instance-profile-name ecsInstanceRole 
```

## Créez le profil d'instance à l'aide de CloudFormation
<a name="create-instance-profile-cfn"></a>

Vous pouvez utiliser AWS CloudFormation pour créer le rôle et le profil d'instance. Choisissez l'une des options suivantes selon que vous utilisez ou non AWS-une politique d'infrastructure gérée ou une politique personnalisée.

### Option 1 : utiliser l'ecsInstanceRole convention de dénomination (recommandée)
<a name="create-instance-profile-cfn-managed"></a>

Lorsque vous utilisez AWS-politique d'infrastructure gérée, vous devez définir explicitement `RoleName` à une valeur commençant par `ecsInstanceRole`. Si vous omettez `RoleName`, CloudFormation génère automatiquement un nom qui ne correspond pas à celui de la politique gérée `iam:PassRole` condition, et les tâches ne peuvent pas être lancées.

```
Resources:
  EcsInstanceRole:
    Type: AWS::IAM::Role
    Properties:
      RoleName: ecsInstanceRole
      AssumeRolePolicyDocument:
        Version: "2012-10-17"
        Statement:
          - Effect: Allow
            Principal:
              Service: ec2.amazonaws.com
            Action: sts:AssumeRole
      ManagedPolicyArns:
        - arn:aws:iam::aws:policy/AmazonECSInstanceRolePolicyForManagedInstances

  EcsInstanceProfile:
    Type: AWS::IAM::InstanceProfile
    Properties:
      InstanceProfileName: ecsInstanceRole
      Roles:
        - !Ref EcsInstanceRole
```

### Option 2 : utiliser un nom de rôle personnalisé
<a name="create-instance-profile-cfn-custom"></a>

Si vous préférez louer CloudFormation générez le nom du rôle, ou vous utilisez un nom personnalisé qui ne commence pas par `ecsInstanceRole`, vous devez ajouter une politique en ligne à votre rôle d'infrastructure qui accorde `iam:PassRole` pour le rôle d'instance.

```
Resources:
  EcsInstanceRole:
    Type: AWS::IAM::Role
    Properties:
      # No RoleName — CFN auto-generates
      AssumeRolePolicyDocument:
        Version: "2012-10-17"
        Statement:
          - Effect: Allow
            Principal:
              Service: ec2.amazonaws.com
            Action: sts:AssumeRole
      ManagedPolicyArns:
        - arn:aws:iam::aws:policy/AmazonECSInstanceRolePolicyForManagedInstances

  EcsInstanceProfile:
    Type: AWS::IAM::InstanceProfile
    Properties:
      Roles:
        - !Ref EcsInstanceRole

  EcsInfrastructureRole:
    Type: AWS::IAM::Role
    Properties:
      AssumeRolePolicyDocument:
        Version: "2012-10-17"
        Statement:
          - Effect: Allow
            Principal:
              Service: ecs.amazonaws.com
            Action: sts:AssumeRole
      ManagedPolicyArns:
        - arn:aws:iam::aws:policy/AmazonECSInfrastructureRolePolicyForManagedInstances
      Policies:
        - PolicyName: PassInstanceRoleToEC2
          PolicyDocument:
            Version: "2012-10-17"
            Statement:
              - Effect: Allow
                Action: iam:PassRole
                Resource: !GetAtt EcsInstanceRole.Arn
                Condition:
                  StringLike:
                    iam:PassedToService: "ec2.*"
```

## Résolution des problèmes
<a name="managed-instances-instance-profile-troubleshooting"></a>

### Les tâches échouent avec iam :PassRole erreur d'autorisation
<a name="managed-instances-instance-profile-ts-passrole"></a>

Si vos tâches échouent à cause d'un `ResourceInitializationError` qui mentionne `iam:PassRole`, vérifiez que le nom de votre rôle d'instance commence par `ecsInstanceRole`. Vous pouvez vérifier le nom généré automatiquement dans CloudFormation console située sous votre console **Ressources** onglet. Si le nom ne correspond pas, soit :
+ Ajouter `RoleName: ecsInstanceRole` à votre `AWS::IAM::Role` ressource.
+ Ajouter un message explicite `iam:PassRole` politique intégrée à votre rôle dans l'infrastructure. Pour plus d’informations, consultez [Option 2 : utiliser un nom de rôle personnalisé](#create-instance-profile-cfn-custom).