sam deploy

Stellen Sie in Ihrer Shell die SAM_CLI_POLL_DELAY Umgebungsvariable auf einen Wert von Sekunden ein, um zu konfigurieren, wie oft die AWS SAM-CLI den CloudFormation Stack-Status überprüft. Dies ist nützlich, wenn Sie Drosselungen von sehen. CloudFormation Diese Umgebungsvariable wird für die Abfrage von describe_stack API-Aufrufen verwendet, die während der Ausführung getätigt werden. sam deploy

Das Folgende ist ein Beispiel für diese Variable:

$ SAM_CLI_POLL_DELAY=5 sam deploy

Eine Liste von Funktionen, die Sie angeben müssen, um das Erstellen bestimmter Stacks CloudFormation zu ermöglichen. Einige Stack-Vorlagen können Ressourcen enthalten, die sich auf Ihre Berechtigungen auswirken AWS-Konto, z. B. durch das Erstellen neuer Benutzer AWS Identity and Access Management (IAM). Für diese Stacks müssen Sie deren Funktionen explizit bestätigen, indem Sie diese Option angeben. Die einzigen gültigen Werte sind CAPABILITY_IAM und CAPABILITY_NAMED_IAM. Wenn Sie über IAM-Ressourcen verfügen, können Sie beide Funktionen angeben. Wenn Sie IAM-Ressourcen mit benutzerdefinierten Namen haben, müssen Sie Folgendes angeben. CAPABILITY_NAMED_IAM Wenn Sie diese Option nicht angeben, gibt der Vorgang einen InsufficientCapabilities Fehler zurück.

Wenn Sie eine Anwendung bereitstellen, die verschachtelte Anwendungen enthält, müssen Sie bestätigen, dass CAPABILITY_AUTO_EXPAND die Anwendung verschachtelte Anwendungen enthält. Weitere Informationen finden Sie unter Bereitstellen verschachtelter Anwendungen.

Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist default. Weitere Informationen zu Konfigurationsdateien finden Sie unter AWS SAMCLIKonfigurationsdatei.

Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert befindet sich samconfig.toml im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter AWS SAMCLIKonfigurationsdatei.

Sie werden aufgefordert, zu bestätigen, ob das AWS SAMCLI berechnete Changeset bereitgestellt wird.

Schalten Sie die Debug-Protokollierung ein, um die AWS SAMCLI generierte Debug-Meldung auszudrucken und Zeitstempel anzuzeigen.

Geben Sie an, ob Ihr CloudFormation Stack zurückgesetzt werden soll, wenn während einer Bereitstellung ein Fehler auftritt. Wenn während einer Bereitstellung ein Fehler auftritt, wird Ihr CloudFormation Stack standardmäßig in den letzten stabilen Zustand zurückgesetzt. Wenn Sie angeben --disable-rollback und während einer Bereitstellung ein Fehler auftritt, werden Ressourcen, die vor dem Auftreten des Fehlers erstellt oder aktualisiert wurden, nicht zurückgesetzt.

Gibt an, ob der CloudFormation Expressmodus verwendet werden soll. Wenn diese Option aktiviert ist, werden die Stapelvorgänge abgeschlossen, sobald die Ressourcenkonfiguration angewendet wurde. Die Ressourcen werden weiterhin im Hintergrund bereit gestellt. Die Bereitstellungszeit kann um das bis zu 4-fache reduziert werden.

Der AWS SAMCLI übergibt das Rollback-Verhalten an den CloudFormation DeploymentConfig Parameter, wenn Sie es ebenfalls angeben--disable-rollback.

Der Standardwert ist --no-express.

Geben Sie an, ob ein Exit-Code ungleich Null zurückgegeben werden soll, wenn keine Änderungen am Stack vorgenommen werden müssen. Das Standardverhalten besteht darin, einen Exitcode ungleich Null zurückzugeben.

Geben Sie diese Option an, um Artefakte hochzuladen, auch wenn sie mit vorhandenen Artefakten im Amazon S3-Bucket übereinstimmen. Passende Artefakte werden überschrieben.

Geben Sie diese Option an, damit die AWS SAMCLI Benutzeranweisungen Sie durch die Bereitstellung führen.

Diese Meldung anzeigen und das Programm beenden.

Eine Zuordnung von Funktionen zu ihrer Amazon ECR-Repository-URI. Referenzfunktionen anhand ihrer logischen ID. Im Folgenden wird ein Beispiel gezeigt:

$ sam deploy --image-repositories Function1=123456789012.dkr.ecr.us-east-1.amazonaws.com/my-repo

Sie können diese Option mehrmals in einem einzigen Befehl angeben.

Der Name des Amazon ECR-Repositorys, in das dieser Befehl das Bild Ihrer Funktion hochlädt. Diese Option ist für Funktionen erforderlich, die mit dem Image Pakettyp deklariert wurden.

Die ID eines AWS Key Management Service (AWS KMS) -Schlüssels, der zum Verschlüsseln von Artefakten verwendet wird, die sich im Amazon S3-Bucket befinden. Wenn Sie diese Option nicht angeben, werden S3-managed Amazon-Verschlüsselungsschlüssel AWS SAM verwendet.

Eine Karte mit Metadaten, die an alle Artefakte angehängt werden, auf die in Ihrer Vorlage verwiesen wird.

Gibt an, ob das Changeset angewendet werden soll. Geben Sie diese Option an, wenn Sie Ihre Stack-Änderungen sehen möchten, bevor Sie das Changeset anwenden. Dieser Befehl erstellt ein CloudFormation Changeset und wird dann beendet, ohne das Changeset anzuwenden. Um das Changeset anzuwenden, führen Sie denselben Befehl ohne diese Option aus.

Zeigen Sie keine Fortschrittsleiste an, wenn Sie Artefakte auf Amazon S3 hochladen.

Eine Liste der thematischen ARNs von Amazon Simple Notification Service (Amazon SNS), die dem Stack CloudFormation zugeordnet sind.

Geben Sie die Aktion an, die ausgeführt werden soll, wenn ein Stack nicht erstellt werden kann.

Die folgenden Optionen sind verfügbar:

Das Standardverhalten ist ROLLBACK.

Das Format der Befehlsausgabe:

Eine Bereitstellung läuft über einen bestimmten Zeitraum. Wenn Sie angeben--output json, AWS SAMCLI druckt das im Verlauf der Bereitstellung einen Stream von JSON-Objekten, eines pro Zeile. Jedes Objekt enthält ein type Feld, das die Art der darin enthaltenen Informationen identifiziert, z. B. den Changeset, Bereitstellungsereignisse, Stack-Ausgaben und das Endergebnis. Im Fehlerfall enthält das endgültige Objekt ein error Objekt, das beschreibt, was schief gelaufen ist.

Eine Zeichenfolge, die CloudFormation Parameterüberschreibungen enthält, die als Schlüssel-Wert-Paare kodiert sind. Bei jeder Überschreibung wird das Format verwendet. ParameterKey=name,ParameterValue=value Mehrere Überschreibungen werden durch Leerzeichen getrennt. Nachfolgend finden Sie zwei Beispiele:

$ sam deploy --parameter-overrides ParameterKey=value1,ParameterValue=value2

$ sam deploy --parameter-overrides ParameterKey=value1,ParameterValue=value2 ParameterKey=hello,ParameterValue=world ParameterKey=apple,ParameterValue=banana

Das spezifische Profil aus Ihrer Anmeldeinformationsdatei, das Anmeldeinformationen abruft AWS .

Das AWS-Region , für das die Bereitstellung erfolgen soll. Beispiel: us-east-1.

Erstellen Sie automatisch Amazon ECR-Repositorys, die Sie für das Paketieren und Bereitstellen von Bereitstellungen ohne Anleitung verwenden können. Diese Option gilt nur für Funktionen und Ebenen mit Angabe. PackageType: Image Wenn Sie die --guided Option angeben, wird sie AWS SAMCLI ignoriert--resolve-image-repos.

Erstellen Sie automatisch einen Amazon S3-Bucket, den Sie für die Paketierung und Bereitstellung für nicht geführte Bereitstellungen verwenden können. Wenn Sie die --guided Option angeben, wird sie von der AWS SAM CLI ignoriert. --resolve-s3 Wenn Sie sowohl die --s3-bucket --resolve-s3 Optionen als auch angeben, tritt ein Fehler auf.

Der Amazon-Ressourcenname (ARN) einer IAM-Rolle, die bei der Anwendung des Changesets übernommen CloudFormation wird.

Der Name des Amazon S3-Buckets, in den dieser Befehl Ihre Vorlage hochlädt. CloudFormation Wenn Ihre Vorlage größer als 51.200 Byte ist, ist entweder die --s3-bucket Option oder die --resolve-s3 Option erforderlich. Wenn Sie sowohl die --s3-bucket --resolve-s3 Optionen als auch angeben, tritt ein Fehler auf.

Das Präfix, das den Namen der Artefakte hinzugefügt wird, die in den Amazon S3-Bucket hochgeladen werden. Der Präfixname ist ein Pfadname (Ordnername) für den Amazon S3-Bucket.

Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

Die Liste der Signaturprofile, mit denen Sie Ihre Bereitstellungspakete signieren können. Diese Option verwendet eine Liste von Schlüssel-Wert-Paaren, wobei der Schlüssel der Name der Funktion oder Ebene ist, die signiert werden soll, und der Wert das Signaturprofil ist, wobei ein optionaler Profilbesitzer durch getrennt ist. : Beispiel, FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner.

(Erforderlich) Der Name des CloudFormation Stacks, auf dem Sie die Bereitstellung durchführen. Wenn Sie einen vorhandenen Stack angeben, aktualisiert der Befehl den Stack. Wenn Sie einen neuen Stapel angeben, wird er mit dem Befehl erstellt.

Eine Liste von Tags, die dem Stapel zugeordnet werden sollen, der erstellt oder aktualisiert wird. CloudFormation gibt diese Tags auch an Ressourcen im Stack weiter, die sie unterstützen.

Der Pfad und der Dateiname, in dem sich Ihre AWS SAM Vorlage befindet.

Gibt JSON für die CloudFormation Vorlage aus. Die Standardausgabe ist YAML.