Eine Umgebung mit einer Workflow-Aktion verknüpfen

Wenn Sie eine Umgebung mit einer unterstützten Workflow-Aktion verknüpfen, werden der Aktion die Standard-IAM-Rolle der Umgebung und die optionale Amazon-VPC zugewiesen. AWS-Konto Die Aktion kann dann AWS-Konto mithilfe der IAM-Rolle eine Verbindung herstellen und diese bereitstellen sowie eine Verbindung zur optionalen Amazon-VPC herstellen.

Verwenden Sie die folgenden Anweisungen, um einer Aktion eine Umgebung zuzuordnen.

Schritt 1: Ordnen Sie die Umgebung einer Workflow-Aktion zu

Gehen Sie wie folgt vor, um eine Umgebung mit einer Workflow-Aktion zu verknüpfen.

Visual

So verknüpfen Sie mithilfe des visuellen Editors eine Umgebung mit einer Workflow-Aktion

1. Öffnen Sie die CodeCatalyst Konsole unter https://codecatalyst.aws/.

2. Wählen Sie Ihr Projekt.

3. Wählen Sie im Navigationsbereich CI/CD und dann Workflows aus.

4. Wählen Sie den Namen Ihres Workflows. Sie können nach dem Quell-Repository oder dem Branch-Namen filtern, in dem der Workflow definiert ist, oder nach dem Workflow-Namen filtern.

5. Wählen Sie Bearbeiten aus.

6. Wählen Sie Visual.

7. Wählen Sie im Workflow-Diagramm eine Aktion aus, die von Umgebungen unterstützt wird. Weitere Informationen finden Sie unter Welche Aktionen unterstützen die Anzeige ihrer Bereitstellungsinformationen in? CodeCatalyst.

8. Wählen Sie die Registerkarte Konfiguration und geben Sie Informationen im Feld Umgebung wie folgt an.

   Umgebung

   Geben Sie die CodeCatalyst Umgebung an, die für die Aktion verwendet werden soll. Die Aktion stellt eine Verbindung mit der AWS-Konto optionalen Amazon VPC her, die in der ausgewählten Umgebung angegeben ist. Die Aktion verwendet die in der Umgebung angegebene Standard-IAM-Rolle, um sich mit der Amazon VPC zu verbinden AWS-Konto, und verwendet die in der Amazon VPC-Verbindung angegebene IAM-Rolle, um eine Verbindung zur Amazon VPC herzustellen.

   Anmerkung

   Wenn die Standard-IAM-Rolle nicht über die für die Aktion erforderlichen Berechtigungen verfügt, können Sie die Aktion so konfigurieren, dass sie eine andere Rolle verwendet. Weitere Informationen finden Sie unter Einer Aktion eine andere IAM-Rolle zuweisen.

   Weitere Informationen zu Umgebungen finden Sie unter Bereitstellung in AWS-Konten und VPCs mit Umgebungen CodeCatalyst undErstellen einer Umgebung.

9. (Optional) Ändern Sie die der Aktion zugeordnete IAM-Rolle. Möglicherweise möchten Sie die Rolle ändern, wenn sie die falschen Berechtigungen für die Aktion enthält.

   Um die Rolle zu ändern:

   1. Im Bereich Was ist in meiner Umgebung? Feld, und wählen Sie das vertikale Ellipsensymbol () .

   2. Wählen Sie eine der folgenden Optionen aus:

      • Wechseln Sie die Rolle. Wählen Sie diese Option, um die von dieser Aktion verwendete IAM-Rolle zu ändern, und zwar nur für diese Aktion. Andere Aktionen verwenden weiterhin die Standard-IAM-Rolle, die in der zugehörigen Umgebung angegeben ist. Weitere Informationen finden Sie unter Einer Aktion eine andere IAM-Rolle zuweisen.

      • Umgebung bearbeiten. Wählen Sie diese Option, um die in Ihrer Umgebung aufgeführte Standard-IAM-Rolle zu ändern. Wenn Sie diese Option wählen, beginnt Ihre Aktion — und jede andere Aktion, die mit derselben Umgebung verknüpft ist — mit der Verwendung der neuen Standard-IAM-Rolle.

        Wichtig

        Seien Sie vorsichtig, wenn Sie die Standard-IAM-Rolle aktualisieren. Das Ändern der Rolle kann dazu führen, dass Aktionen fehlschlagen, wenn die Berechtigungen in der Rolle nicht für alle Aktionen ausreichen, die die Umgebung gemeinsam nutzen.

10. (Optional) Wählen Sie „Validieren“, um den YAML-Code des Workflows vor dem Commit zu überprüfen.

11. Wählen Sie Commit, geben Sie eine Commit-Nachricht ein und wählen Sie erneut Commit aus.

YAML

Um mithilfe des YAML-Editors eine Umgebung mit einer Workflow-Aktion zu verknüpfen

1. Öffnen Sie die CodeCatalyst Konsole unter https://codecatalyst.aws/.

2. Wählen Sie Ihr Projekt.

3. Wählen Sie im Navigationsbereich CI/CD und dann Workflows aus.

4. Wählen Sie den Namen Ihres Workflows. Sie können nach dem Quell-Repository oder dem Branch-Namen filtern, in dem der Workflow definiert ist, oder nach dem Workflow-Namen filtern.

5. Wählen Sie Bearbeiten aus.

6. Wählen Sie YAML.

7. Fügen Sie in der Workflow-Aktion, die Sie einer Umgebung zuordnen möchten, Code hinzu, der dem folgenden ähnelt:

   action-name:
     Environment:
       Name: environment-name

   Weitere Informationen finden Sie im Aktionstypen Thema. Dieses Thema enthält Links zur Dokumentation für jede Aktion, einschließlich der zugehörigen YAML-Referenz.

8. (Optional) Wenn Sie möchten, dass die Aktion eine andere Rolle als die Standard-IAM-Rolle verwendet, die in der Umgebung aufgeführt ist, fügen Sie einen Connections: Abschnitt hinzu, der die Rolle enthält, die Sie verwenden möchten. Weitere Informationen finden Sie unter Einer Aktion eine andere IAM-Rolle zuweisen.

9. (Optional) Wählen Sie „Validieren“, um den YAML-Code des Workflows vor dem Commit zu überprüfen.

10. Wählen Sie Commit, geben Sie eine Commit-Nachricht ein und wählen Sie erneut Commit aus.

Schritt 2: Fügen Sie Bereitstellungsinformationen hinzu CodeCatalyst

Nachdem Sie eine Umgebung mit einer Workflow-Aktion verknüpft haben, können Sie die Seiten „Bereitstellungsaktivität“ und „Bereitstellungsziel“ in der CodeCatalyst Konsole mit Bereitstellungsinformationen füllen. Verwenden Sie die folgenden Anweisungen, um diese Seiten zu füllen.

Anmerkung

Nur bei wenigen Aktionen wird die Anzeige ihrer Bereitstellungsinformationen in der CodeCatalyst Konsole unterstützt. Weitere Informationen finden Sie unter Welche Aktionen unterstützen die Anzeige ihrer Bereitstellungsinformationen in? CodeCatalyst.

Um Bereitstellungsinformationen hinzuzufügen CodeCatalyst

1. Wenn ein Workflow-Lauf nicht automatisch gestartet wurde, als Sie Ihre Änderungen übernommen habenSchritt 1: Ordnen Sie die Umgebung einer Workflow-Aktion zu, starten Sie einen Workflow-Lauf manuell wie folgt:

   1. Wählen Sie im Navigationsbereich CI/CD und dann Workflows aus.

   2. Wählen Sie den Namen des Workflows aus, in dem Sie eine Ausführung starten möchten. Sie können nach dem Quell-Repository oder dem Branch-Namen filtern, in dem der Workflow definiert ist, oder nach dem Workflow-Namen filtern.

   3. Wählen Sie Ausführen aus.

   Bei der Workflow-Ausführung wird eine neue Bereitstellung gestartet, CodeCatalyst woraufhin Bereitstellungsinformationen hinzugefügt CodeCatalyst werden müssen.

2. Stellen Sie sicher, dass die Bereitstellungsaktivität zur CodeCatalyst Konsole hinzugefügt wurde:

   1. Wählen Sie im Navigationsbereich CI/CD und dann Environments aus.

   2. Wählen Sie Ihre Umgebung aus (z. B.Production).

   3. Wählen Sie die Registerkarte Bereitstellungsaktivität und vergewissern Sie sich, dass eine Bereitstellung den Status SUCCEED hat. Dies weist darauf hin, dass Ihre Anwendungsressourcen bei einer Workflow-Ausführung erfolgreich bereitgestellt wurden.

   4. Wählen Sie die Registerkarte Bereitstellungsziele und überprüfen Sie, ob Ihre Anwendungsressourcen angezeigt werden.