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.
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.
-
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: -
Benutze das Folgende AWS CLI Befehl zum Erstellen einer Rolle mit dem Namen
ecsInstanceRolemithilfe 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 -
Hängen Sie das an AWS verwaltet
AmazonECSInstanceRolePolicyForManagedInstancesRichtlinie zurecsInstanceRoleRolle.aws iam attach-role-policy \ --role-name ecsInstanceRole \ --policy-arn arn:aws:iam::aws:policy/AmazonECSInstanceRolePolicyForManagedInstancesAnmerkungWenn 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:StartTelemetrySessionecs: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:
-
Hinzufügen
RoleName: ecsInstanceRolezu deinemAWS::IAM::RoleRessource. -
Fügen Sie eine explizite
iam:PassRolePassen Sie die Richtlinie an Ihre Infrastrukturrolle an. Weitere Informationen finden Sie unter Option 2: Verwenden Sie einen benutzerdefinierten Rollennamen.