View a markdown version of this page

Instance-Profil von Amazon ECS Managed Instances - Amazon Elastic Container Service

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Instance-Profil von Amazon ECS Managed Instances

Ein Instance-Profil ist ein IAM-Container, der genau eine IAM-Rolle enthält und es Amazon ECS Managed Instances ermöglicht, diese Rolle sicher anzunehmen. Das Instance-Profil enthält eine Instance-Rolle, die der ECS-Agent übernimmt, um Instances bei Clustern zu registrieren und mit dem ECS-Service zu kommunizieren.

Wichtig

Wenn Sie Amazon ECS Managed Instances mit dem verwenden AmazonECSInfrastructureRolePolicyForManagedInstances verwaltete Richtlinie, der Rollenname der Instanz muss mit beginnen ecsInstanceRole. Die politischen Geltungsbereiche iam:PassRole zu arn:aws:iam::*:role/ecsInstanceRole*, sodass ein nicht übereinstimmender Name beim Start der Aufgabe zu einem Autorisierungsfehler führt. Das ist üblich bei CloudFormation wenn du weglässt RoleName, weil CloudFormation generiert automatisch Namen wie MyStack-InstanceRole-ABC123.

Wenn Sie stattdessen eine benutzerdefinierte Infrastrukturrollenrichtlinie verwenden, kann die Instanzrolle einen beliebigen Namen haben, sofern Ihre Richtlinie eine iam:PassRole Grant, der auf den ARN der Instanzrolle abzielt.

Erstellen Sie die Rolle mit der Vertrauensrichtlinie.

Ersetze alles user input mit deinen eigenen Informationen.

  1. Erstellen Sie eine Datei namens ecsInstanceRole-trust-policy.json, die die Vertrauensrichtlinie enthält, die für die IAM-Rolle verwendet werden soll. Die Datei sollte Folgendes enthalten:

    JSON
    { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "ec2.amazonaws.com"}, "Action": "sts:AssumeRole" } ] }
  2. Benutze das Folgende AWS CLI Befehl zum Erstellen einer Rolle mit dem Namen ecsInstanceRole mithilfe der Vertrauensrichtlinie, die Sie im vorherigen Schritt erstellt haben.

    aws iam create-role \ --role-name ecsInstanceRole \ --assume-role-policy-document file://ecsInstanceRole-trust-policy.json
  3. Hängen Sie das an AWS verwaltet AmazonECSInstanceRolePolicyForManagedInstances Richtlinie zur ecsInstanceRole Rolle.

    aws iam attach-role-policy \ --role-name ecsInstanceRole \ --policy-arn arn:aws:iam::aws:policy/AmazonECSInstanceRolePolicyForManagedInstances
    Anmerkung

    Wenn Sie Berechtigungen mit geringsten Rechten anwenden und stattdessen Ihre eigenen Berechtigungen angeben, können Sie die folgenden Berechtigungen hinzufügen, um aufgabenbezogene Probleme mit Amazon ECS Managed Instances zu beheben:

    • ecs:StartTelemetrySession

    • ecs:PutSystemLogEvents

Sie können die Rolle auch mithilfe des Workflows für benutzerdefinierte Vertrauensrichtlinien der IAM-Konsole erstellen. Weitere Informationen finden Sie unter Erstellen einer Rolle mit benutzerdefinierten Vertrauensrichtlinien (Konsole) im IAM-Benutzerhandbuch.

Wenn Sie die Datei erstellt haben, müssen Sie Ihrem Benutzer die Berechtigung erteilen, die Rolle an Amazon ECS zu übergeben.

Erstellen Sie das Instanzprofil mit dem AWS CLI

Nachdem Sie die Rolle erstellt haben, erstellen Sie das Instance-Profil mit der AWS CLI.

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

Fügen Sie dem Instance-Profil die IAM-Rolle hinzu.

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

Überprüfen Sie, ob das Projekt erfolgreich erstellt wurde.

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

Erstellen Sie das Instanzprofil mit CloudFormation

Sie können verwenden AWS CloudFormation um die Instanzrolle und das Instanzprofil zu erstellen. Wählen Sie je nachdem, ob Sie das verwenden, eine der folgenden Optionen AWS-verwaltete Infrastrukturrichtlinie oder eine benutzerdefinierte Richtlinie.

Option 1: Verwenden Sie das ECSInstanceRole Namenskonvention (empfohlen)

Wenn Sie das verwenden AWS-verwaltete Infrastrukturrichtlinie, die Sie explizit festlegen müssen RoleName auf einen Wert, der beginnt mit ecsInstanceRole. Wenn Sie weglassen RoleName, CloudFormation generiert automatisch einen Namen, der nicht mit dem der verwalteten Richtlinie übereinstimmt iam:PassRole Zustand, und Aufgaben können nicht gestartet werden.

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: Verwenden Sie einen benutzerdefinierten Rollennamen

Wenn Sie es vorziehen zu vermieten CloudFormation generieren Sie den Rollennamen, oder Sie verwenden einen benutzerdefinierten Namen, der nicht mit beginnt ecsInstanceRole, müssen Sie Ihrer Infrastrukturrolle eine Inline-Richtlinie hinzufügen, die Folgendes gewährt iam:PassRole für die Instanzrolle.

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.*"

Fehlerbehebung

Aufgaben schlagen mit iam fehl:PassRole Fehler bei der Autorisierung

Wenn Ihre Aufgaben mit einem fehlschlagen ResourceInitializationError das erwähnt iam:PassRole, stellen Sie sicher, dass der Name Ihrer Instanzrolle mit beginnt ecsInstanceRole. Sie können den automatisch generierten Namen in der CloudFormation Konsole unter deinem Stack Ressourcen Tab. Wenn der Name nicht übereinstimmt, entweder: