sam package - AWS Serverless Application Model
VerwendungArgumenteOptionenBeispiel

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.

sam package

Die AWS Serverless Application Model Befehlszeilenschnittstelle (AWS SAM CLI) packt eine AWS SAM Anwendung.

Dieser Befehl erstellt eine .zip Datei mit Ihrem Code und Ihren Abhängigkeiten und lädt die Datei auf Amazon Simple Storage Service (Amazon S3) hoch. AWS SAM aktiviert die Verschlüsselung für alle in Amazon S3 gespeicherten Dateien. Anschließend wird eine Kopie Ihrer AWS SAM Vorlage zurückgegeben und Verweise auf lokale Artefakte durch den Amazon S3 S3-Speicherort ersetzt, an den der Befehl die Artefakte hochgeladen hat.

Wenn Sie diesen Befehl verwenden, ist standardmäßig AWS SAM CLI geht davon aus, dass Ihr aktuelles Arbeitsverzeichnis das Stammverzeichnis Ihres Projekts ist. Das AWS SAM CLI versucht zunächst, eine mit dem sam build Befehl erstellte Vorlagendatei zu finden, die sich im .aws-sam Unterordner befindet und benannt template.yaml ist. Als Nächstes AWS SAM CLI versucht, eine Vorlagendatei mit dem Namen template.yaml oder template.yml im aktuellen Arbeitsverzeichnis zu finden. Wenn Sie die --template Option angeben, AWS SAM CLIDas Standardverhalten wird außer Kraft gesetzt und packt nur diese AWS SAM Vorlage und die lokalen Ressourcen, auf die sie verweist.

Anmerkung

sam deployführt jetzt implizit die Funktionalität von aus. sam package Sie können den sam deploy Befehl direkt verwenden, um Ihre Anwendung zu verpacken und bereitzustellen.

Verwendung

$ sam package <arguments> <options>

Argumente

Ressourcen-ID

Die ID der Lambda-Funktion, die verpackt werden soll.

Dieses Argument ist optional. Wenn Ihre Anwendung eine einzelne Lambda-Funktion enthält, AWS SAM CLI wird sie gepackt. Wenn Ihre Anwendung mehrere Funktionen enthält, geben Sie die ID der Funktion an, um eine einzelne Funktion zu verpacken.

Gültige Werte: Die logische ID oder Ressource der RessourceARN.

Optionen

--config-env TEXT

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

--config-file PATH

Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert ist „samconfig.toml“ im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter AWS SAM CLI Konfigurationsdatei.

--debug

Aktiviert die Debug-Protokollierung, um die Debug-Nachricht zu drucken, die generiert wurde von AWS SAM CLI und zeigt Zeitstempel an.

--force-upload

Überschreiben Sie vorhandene Dateien im Amazon S3 S3-Bucket. Geben Sie dieses Flag an, um Artefakte hochzuladen, auch wenn sie mit vorhandenen Artefakten im Amazon S3 S3-Bucket übereinstimmen.

--help

Zeigt diese Nachricht an und wird beendet.

--image-repository TEXT

Das Repository URI von Amazon Elastic Container Registry (AmazonECR), in das dieser Befehl das Image Ihrer Funktion hochlädt. Erforderlich für Funktionen, die mit dem Image Pakettyp deklariert wurden.

--kms-key-id TEXT

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

--metadata

(Optional) Eine Metadatenübersicht, die an alle Artefakte angehängt werden kann, auf die in Ihrer Vorlage verwiesen wird.

--no-progressbar

Zeigen Sie keinen Fortschrittsbalken an, wenn Sie Artefakte auf Amazon S3 hochladen.

--output-template-file PATH

Der Pfad zu der Datei, in die der Befehl die verpackte Vorlage schreibt. Wenn Sie keinen Pfad angeben, schreibt der Befehl die Vorlage in die Standardausgabe.

--profile TEXT

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

--region TEXT

Die AWS Region, in der die Bereitstellung erfolgen soll. Beispiel: us-east-1.

--resolve-s3

Erstellen Sie automatisch einen Amazon S3 S3-Bucket, der für die Verpackung verwendet werden soll. Wenn Sie --s3-bucket sowohl die als auch die --resolve-s3 Optionen angeben, tritt ein Fehler auf.

--s3-bucket TEXT

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

--s3-prefix TEXT

Dem Namen der Artefakte, die in den Amazon S3 S3-Bucket hochgeladen werden, wurde ein Präfix hinzugefügt. Der Präfixname ist ein Pfadname (Ordnername) für den Amazon S3 S3-Bucket. Dies gilt nur für Funktionen, die mit dem Zip Pakettyp deklariert wurden.

--save-params

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

--signing-profiles LIST

(Optional) Die Liste der Signaturprofile, mit denen Sie Ihre Bereitstellungspakete signieren können. Dieser Parameter 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 der optionale Profilbesitzer durch getrennt ist. : Beispiel, FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner.

--template-file, --template, -t PATH

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

Anmerkung

Wenn Sie diese Option angeben, werden nur die Vorlage und die lokalen Ressourcen, auf die sie verweist, AWS SAM verpackt.

--use-json

Ausgabe JSON für die AWS CloudFormation Vorlage. Standardmäßig wird YAML verwendet.

Beispiel

Im folgenden Beispiel werden Artefakte für eine Lambda-Funktion und CodeDeploy Anwendungen erstellt und verpackt. Artefakte werden in einen Amazon S3 S3-Bucket hochgeladen. Die Ausgabe des Befehls ist eine neue Datei mit dem Namen package.yml.

$ sam package \
  --template-file template.yml \
  --output-template-file package.yml \
  --s3-bucket amzn-s3-demo-bucket