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.
Bootstrap für dieselbe Pipeline
Diese Seite enthält Referenzinformationen für AWS Serverless Application Model Befehlszeilenschnittstelle (AWS SAM CLI) sam local pipeline bootstrap Unterbefehl.
Für eine Einführung in die AWS SAM CLI, siehe Was ist der AWS SAM CLI?
Das sam pipeline bootstrap Unterbefehl generiert das erforderliche AWS Infrastrukturressourcen für die Verbindung zu Ihrem CI/CD System. Dieser Schritt muss für jede Bereitstellungsphase in Ihrer Pipeline ausgeführt werden, bevor der ausgeführt wird sam pipeline init Befehl.
Dieser Unterbefehl richtet Folgendes ein AWS Infrastrukturressourcen:
-
Option zur Konfiguration von Pipeline-Berechtigungen über:
-
Ein Pipeline-IAM-Benutzer mit Zugriffsschlüssel-ID und Zugangsdaten für den geheimen Schlüssel, die mit dem geteilt werden sollen CI/CD System.
AnmerkungWir empfehlen, die Zugangsschlüssel regelmäßig zu wechseln. Weitere Informationen finden Sie unter Wechseln Sie die Zugriffsschlüssel regelmäßig für Anwendungsfälle, für die langfristige Anmeldeinformationen erforderlich sind in der IAM-Benutzerhandbuch.
-
Unterstützt CI/CD Plattformen über OIDC. Für eine Einführung in die Verwendung von OIDC mit AWS SAM Pipeline, gehen Sie zu So verwenden Sie die OIDC-Authentifizierung mit Pipelines AWS SAM.
-
-
Ein CloudFormation IAM-Rolle für die Ausführung, übernommen von CloudFormation um das bereitzustellen AWS SAM Anwendung.
-
Ein Amazon S3-Bucket zur Aufbewahrung der AWS SAM Artefakte.
-
Optional ein Amazon ECR-Image-Repository für Lambda-Bereitstellungspakete für Container-Images (falls Sie über eine Ressource des Pakettyps verfügen)
Image).
Lauf nicht sam pipeline bootstrap mit einer nicht vertrauenswürdigen Konfigurationsdatei. Der OIDC-Anbieter und die Berechtigungseinstellungen der Datei bestimmen, wer die IAM-Rollen übernehmen kann, die dieser Befehl erstellt.
Usage
$sam pipeline bootstrap<options>
Optionen
--bitbucket-repo-uuidTEXT-
Die UUID des Bitbucket-Repositorys. Diese Option ist spezifisch für die Verwendung von Bitbucket OIDC für Berechtigungen.
AnmerkungDieser Wert ist unter zu finden https://bitbucket.org/
workspace/repository/admin/addon/admin/pipelines/openid-verbinden --bucketTEXT-
Der ARN des Amazon S3-Buckets, der den enthält AWS SAM Artefakte.
--cicd-providerTEXT-
Die CI/CD Plattform für die AWS SAM Pipeline.
--cloudformation-execution-roleTEXT-
Der ARN der IAM-Rolle, die übernommen werden soll von CloudFormation bei der Bereitstellung des Stacks der Anwendung. Geben Sie dies nur an, wenn Sie Ihre eigene Rolle verwenden möchten. Andernfalls erstellt der Befehl eine neue Rolle.
--config-envTEXT-
Der Umgebungsname, der die zu verwendenden Standardparameterwerte in der Konfigurationsdatei angibt. Der Standardwert ist
default. Weitere Informationen zu Konfigurationsdateien finden Sie unter AWS SAMCLIKonfigurationsdatei. --config-filePATH-
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert ist
samconfig.tomlim Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter AWS SAMCLIKonfigurationsdatei. --confirm-changeset | --no-confirm-changeset-
Aufforderung zur Bestätigung der Bereitstellung Ihrer Ressourcen.
--create-image-repository | --no-create-image-repository-
Geben Sie an, ob ein Amazon ECR-Image-Repository erstellt werden soll, falls keines angegeben ist. Das Amazon ECR-Repository enthält die Container-Images von Lambda Event Functions oder Ebenen mit dem Pakettyp
Image. Der Standardwert ist--no-create-image-repository. --debug-
Schaltet die Debug-Protokollierung ein und druckt Debug-Meldungen aus, die AWS SAM CLI generiert und um Zeitstempel anzuzeigen.
--deployment-branchTEXT-
Name des Zweigs, von dem aus die Bereitstellungen erfolgen. Diese Option ist spezifisch für die Verwendung GitHub Aktionen OIDC für Berechtigungen.
--github-orgTEXT-
Das GitHub Organisation, zu der das Repositorium gehört. Wenn keine Organisation existiert, geben Sie den Benutzernamen des Repository-Besitzers ein. Diese Option ist spezifisch für die Verwendung GitHub Aktionen OIDC für Berechtigungen.
--github-repoTEXT-
Name des GitHub Repository, von dem aus die Bereitstellungen erfolgen. Diese Option ist spezifisch für die Verwendung GitHub Aktionen OIDC für Berechtigungen.
--gitlab-groupTEXT-
Das GitLab Gruppe, zu der das Repository gehört. Diese Option ist spezifisch für die Verwendung GitLab OIDC für Berechtigungen.
--gitlab-projectTEXT-
Das GitLab Name des Projekts. Diese Option ist spezifisch für die Verwendung GitLab OIDC für Berechtigungen.
--help, -h-
Zeigt diese Meldung an und beendet das Programm.
--image-repositoryTEXT-
Der ARN eines Amazon ECR-Image-Repositorys, das die Container-Images von Lambda-Funktionen enthält, oder Ebenen mit dem Pakettyp
Image. Falls angegeben, die--create-image-repositoryOptionen werden ignoriert. Wenn nicht angegeben und--create-image-repositoryangegeben ist, erstellt der Befehl einen. --interactive | --no-interactive-
Deaktiviert die interaktive Aufforderung zur Eingabe von Bootstrap-Parametern und schlägt fehl, wenn erforderliche Parameter fehlen. Der Standardwert ist
--interactive. Für diesen Befehl gilt:--stageist der einzige erforderliche Parameter.AnmerkungWenn
--no-interactivewird zusammen mit angegeben--use-oidc-provider, alle erforderlichen Parameter für Ihren OIDC-Anbieter müssen enthalten sein. --oidc-client-idTEXT-
Die Client-ID, die für die Verwendung mit Ihrem OIDC-Anbieter konfiguriert ist.
--oidc-provider[github-actions | gitlab | bitbucket-pipelines]-
Name des CI/CD Anbieter, der für OIDC-Berechtigungen verwendet wird. GitLab, GitHub, und Bitbucket werden unterstützt.
--oidc-provider-urlTEXT-
Die URL für den OIDC-Anbieter. Der Wert muss beginnen mit
https://. --permissions-provider[oidc | iam]-
Wählen Sie einen Berechtigungsanbieter aus, der die Pipeline-Ausführungsrolle übernimmt. Der Standardwert ist
iam. --pipeline-execution-roleTEXT-
Der ARN der IAM-Rolle, die der Pipeline-Benutzer übernehmen muss, um in dieser Phase zu arbeiten. Geben Sie dies nur an, wenn Sie Ihre eigene Rolle verwenden möchten. Wenn nicht angegeben, erstellt dieser Befehl eine neue Rolle.
--pipeline-userTEXT-
Der Amazon-Ressourcenname (ARN) des IAM-Benutzers, dessen Zugriffsschlüssel-ID und sein geheimer Zugriffsschlüssel gemeinsam mit dem CI/CD System. Es wird verwendet, um diesem IAM-Benutzer die Erlaubnis zu erteilen, auf das entsprechende zuzugreifen AWS Konto. Wenn nicht angegeben, erstellt der Befehl einen IAM-Benutzer zusammen mit der Zugriffsschlüssel-ID und den Anmeldeinformationen für den geheimen Zugriffsschlüssel.
--profileTEXT-
Das spezifische Profil aus Ihrer Anmeldeinformationsdatei, das abgerufen wird AWS Anmeldeinformationen.
--regionTEXT-
Die AWS Region, in der bereitgestellt werden soll. Beispiel,
us-east-1. --save-params-
Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, im AWS SAM Konfigurationsdatei.
--stageTEXT-
Der Name der entsprechenden Bereitstellungsphase. Es wird als Suffix für das erstellte verwendet AWS Infrastrukturressourcen.
Fehlerbehebung
Fehler: Fehlender erforderlicher Parameter
Wann --no-interactive wird zusammen mit angegeben --use-oidc-provider Wenn keiner der erforderlichen Parameter angegeben ist, wird diese Fehlermeldung zusammen mit einer Beschreibung der fehlenden Parameter angezeigt.
Beispiel
Das folgende Beispiel erstellt die AWS Ressourcen, die für die Erstellung Ihrer erforderlich sind CI/CD System, und es aktiviert die Debug-Protokollierung und druckt Debug-Meldungen aus, die vom AWS SAM CLI: verwendet ein generiertes Ereignis für lokale Tests mithilfe eines s3.json Ereignis, um eine Lambda-Funktion lokal aufzurufen
$sam pipeline bootstrap --debug