View a markdown version of this page

sincronizzazione sam - AWS Serverless Application Model

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

sincronizzazione sam

Questa pagina fornisce informazioni di riferimento per AWS Serverless Application Model Interfaccia a riga di comando (AWS SAM CLI) sam sync comando.

Il sam sync il comando sincronizza le modifiche dell'applicazione locale con Cloud AWS.

Importante

Non correre sam sync su codice non attendibile. Il comando crea il progetto nell'ambiente locale, che esegue gli strumenti di compilazione e gli script definiti dal progetto. Quindi distribuisce le risorse del modello sul tuo AWS account con le tue credenziali.

Utilizzo

$ sam sync <options>

Opzioni

--base-dir, -s DIRECTORY

Risolve i percorsi relativi al codice sorgente della funzione o del livello rispetto a questa directory. Utilizzate questa opzione per modificare il modo in cui vengono risolti i percorsi relativi alle cartelle del codice sorgente. Per impostazione predefinita, i percorsi relativi vengono risolti rispetto a AWS SAM posizione del modello.

Oltre alle risorse nell'applicazione principale o nello stack che stai creando, questa opzione si applica anche alle applicazioni o agli stack annidati. Inoltre, questa opzione si applica ai seguenti tipi e proprietà di risorse:

  • Tipo di risorsa: AWS::Serverless::Function Proprietà: CodeUri

  • Tipo di risorsa: AWS::Serverless::Function Attributo della risorsa: Metadata Inserimento: DockerContext

  • Tipo di risorsa: AWS::Serverless::LayerVersion Proprietà: ContentUri

  • Tipo di risorsa: AWS::Lambda::Function Proprietà: Code

  • Tipo di risorsa: AWS::Lambda::LayerVersion Proprietà: Content

--build-image TEXT

L'URI per immagine del contenitore che desideri utilizzare per creare la tua applicazione. Per impostazione predefinita, AWS SAM utilizza l'URI del repository di immagini del contenitore di Amazon Elastic Container Registry (Amazon ECR) pubblico. Specificate questa opzione per utilizzare un'immagine diversa.

È possibile utilizzare questa opzione più volte in un unico comando. Ogni opzione accetta una stringa o una coppia chiave-valore.

  • Stringa — Specifica l'URI dell'immagine del contenitore che verranno utilizzate da tutte le risorse dell'applicazione. Di seguito è riportato un esempio:

    $ sam sync --build-image amazon/aws-sam-cli-build-image-python3.8
  • Key-value paio — Specificare il nome della risorsa come chiave e l'URI dell'immagine del contenitore da utilizzare con quella risorsa come valore. Utilizzate questo formato per specificare un diverso URI dell'immagine del contenitore per ogni risorsa dell'applicazione. Di seguito è riportato un esempio:

    $ sam sync --build-image Function1=amazon/aws-sam-cli-build-image-python3.8

Questa opzione si applica solo se --use-container è specificata l'opzione, altrimenti si verificherà un errore.

--build-in-source | --no-build-in-source

Fornisce --build-in-source per creare il progetto direttamente nella cartella sorgente.

Il --build-in-source l'opzione supporta i seguenti runtime e metodi di compilazione:

  • Runtime — Qualsiasi Node.js runtime supportato da sam init --runtime opzione.

  • Metodi di costruzione — Makefile, esbuild.

Il --build-in-source l'opzione non è compatibile con le seguenti opzioni:

  • --use-container

Default: --no-build-in-source

--capabilities LIST

Un elenco di funzionalità che specifichi di consentire CloudFormation per creare determinati stack. Alcuni modelli di stack potrebbero includere risorse che possono influire sulle autorizzazioni del tuo Account AWS. Ad esempio, creando nuovi AWS Identity and Access Management utenti (IAM). Specificate questa opzione per sovrascrivere i valori predefiniti. I valori validi includono quanto segue:

  • CAPABILITY_IAM

  • CAPABILITY_NAMED_IAM

  • CAPABILITY_RESOURCE_POLICY

  • CAPABILITY_AUTO_EXPAND

Predefinito: CAPABILITY_NAMED_IAM e CAPABILITY_AUTO_EXPAND

--code

Per impostazione predefinita, AWS SAM sincronizza tutte le risorse dell'applicazione. Specifica questa opzione per sincronizzare solo le risorse di codice, che includono quanto segue:

  • AWS::Serverless::Function

  • AWS::Lambda::Function

  • AWS::Serverless::LayerVersion

  • AWS::Lambda::LayerVersion

  • AWS::Serverless::Api

  • AWS::ApiGateway::RestApi

  • AWS::Serverless::HttpApi

  • AWS::ApiGatewayV2::Api

  • AWS::Serverless::StateMachine

  • AWS::StepFunctions::StateMachine

Per sincronizzare le risorse di codice, AWS SAM utilizza AWS le API di servizio direttamente, invece di distribuirle tramite AWS CloudFormation. Per aggiornare il tuo CloudFormation pila, corri sam sync --watch o sam deploy.

--config-env TEXT

Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta AWS SAMCLIfile di configurazione.

--config-file PATH

Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è»samconfig.toml"nella cartella principale della cartella del progetto. Per ulteriori informazioni sui file di configurazione, consulta AWS SAMCLIfile di configurazione.

--dependency-layer | --no-dependency-layer

Specifica se separare le dipendenze delle singole funzioni in un altro livello per accelerare il processo di sincronizzazione.

Un AWS::Serverless::WebFunction non può usare i livelli, quindi le sue dipendenze rimangono sempre nel pacchetto di distribuzione.

Default: --dependency-layer

--express | --no-express

Specifica se utilizzare CloudFormation Modalità Express per le implementazioni dell'infrastruttura. Quando è attiva, le operazioni sullo stack vengono completate una volta applicata la configurazione delle risorse. Le risorse continuano a essere pronte in background.

La modalità Express si applica solo al percorso di sincronizzazione dell'infrastruttura. Code-only bypass delle sincronizzazioni (aggiornamenti di Lambda Event Function, implementazioni) CloudFormation e non sono influenzati da questa opzione.

Il valore predefinito è --no-express.

Prossima modifica delle impostazioni predefinite

L'impostazione predefinita cambia in --express il 1° settembre 2026.

--image-repository TEXT

Il nome del repository Amazon Elastic Container Registry (Amazon ECR) in cui questo comando carica l'immagine della funzione. Richiesto per le funzioni dichiarate con Image tipo di pacchetto.

--image-repositories TEXT

Una mappatura delle funzioni all'URI del loro repository Amazon ECR. Fai riferimento alle funzioni in base al loro ID logico. Di seguito è riportato un esempio:

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

È possibile specificare questa opzione più volte in un unico comando.

--kms-key-id TEXT

L'ID di un AWS Key Management Service (AWS KMS) chiave utilizzata per crittografare gli artefatti inattivi nel bucket Amazon S3. Se non specifichi questa opzione, AWS SAM utilizza Amazon S3-managed chiavi di crittografia.

--metadata

Una mappa di metadati da allegare a tutti gli artefatti a cui fai riferimento nel modello.

--notification-arns LIST

Un elenco di argomenti di Amazon Simple Notification Service (Amazon SNS) che CloudFormation si associa allo stack.

--no-use-container

Un'opzione che consente di utilizzare il toolkit IDE per impostare il comportamento predefinito.

--parameter-overrides

Una stringa che contiene CloudFormation i parametri sostituiscono le coppie codificate come coppie chiave-valore. Usa lo stesso formato di AWS Command Line Interface (AWS CLI). Il AWS SAM CLI il formato è composto da parole chiave e valore esplicite, ogni override è separato da uno spazio. Di seguito, sono riportati due esempi:

  • --parameter-overrides ParameterKey=hello,ParameterValue=world

  • --parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana

--resource TEXT

Specifica il tipo di risorsa da sincronizzare. Per sincronizzare più risorse, puoi specificare questa opzione più volte. Questa opzione è supportata con --code opzione. Il valore deve essere una delle risorse elencate in --code. Ad esempio, --resource AWS::Serverless::Function --resource AWS::Serverless::LayerVersion.

--resource-id TEXT

Specifica l'ID della risorsa da sincronizzare. Per sincronizzare più risorse, puoi specificare questa opzione più volte. Questa opzione è supportata con --code opzione. Ad esempio, --resource-id Function1 --resource-id Function2.

--role-arn TEXT

L'Amazon Resource Name (ARN) di un ruolo IAM che CloudFormation presuppone quando si applica il changeset.

--s3-bucket TEXT

Il nome del bucket Amazon Simple Storage Service (Amazon S3) in cui questo comando carica il tuo CloudFormation modello. Se il modello è più grande di 51.200 byte, allora --s3-bucket o il --resolve-s3 l'opzione è obbligatoria. Se si specificano entrambi --s3-bucket e --resolve-s3 opzioni, quindi si verifica un errore.

Se si specifica questa opzione, il codice di un AWS::Serverless::WebFunction viene caricato anche in questo bucket. Altrimenti, viene caricato in un bucket di codice che appartiene allo stack. Per ulteriori informazioni, consulta Creazione e distribuzione di Lambda Web Functions.

--s3-prefix TEXT

Il prefisso aggiunto ai nomi degli artefatti che carichi nel bucket Amazon S3. Il nome del prefisso è il nome del percorso (nome della cartella) per il bucket Amazon S3. Questo vale solo per le funzioni dichiarate con Zip tipo di pacchetto.

--save-params

Salva i parametri forniti nella riga di comando nel file AWS SAM file di configurazione.

--skip-deploy-sync | --no-skip-deploy-sync

Specifica --skip-deploy-sync per saltare la sincronizzazione iniziale dell'infrastruttura se non è richiesta. Il AWS SAM CLI confronterà il tuo locale AWS SAM modello con quello distribuito CloudFormation modellare ed eseguire una distribuzione solo se viene rilevata una modifica.

Specifica --no-skip-deploy-sync per eseguire un CloudFormation distribuzione ogni volta sam sync viene eseguito.

Per ulteriori informazioni, consulta Salta l'iniziale CloudFormation implementazione.

Default: --skip-deploy-sync

--stack-name TEXT

Il nome del CloudFormation stack per la tua applicazione.

Questa opzione è obbligatoria.

--tags LIST

Un elenco di tag da associare allo stack creato o aggiornato. CloudFormation inoltre propaga questi tag alle risorse dello stack che li supportano.

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

Il percorso e il nome del file in cui si trova AWS SAM si trova il modello.

Nota

Se si specifica questa opzione, allora AWS SAM distribuisce solo il modello e le risorse locali a cui fa riferimento.

--use-container, -u

Se le tue funzioni dipendono da pacchetti con dipendenze compilate in modo nativo, usa questa opzione per creare la tua funzione all'interno di un AWS Lambda-come Docker contenitore.

Nota

Attualmente, questa opzione non è compatibile con --dependency-layer. Se usi --use-container con --dependency-layer, il AWS SAM CLI ti informa e prosegue con --no-dependency-layer.

--watch

Avvia un processo che controlla le modifiche nell'applicazione locale e le sincronizza automaticamente con Cloud AWS. Per impostazione predefinita, quando si specifica questa opzione, AWS SAM sincronizza tutte le risorse dell'applicazione man mano che le aggiorni. Con questa opzione, AWS SAM esegue un'iniziale CloudFormation distribuzione. Quindi, AWS SAM utilizza AWS API di servizio per aggiornare le risorse di codice. AWS SAM utilizza CloudFormation per aggiornare le risorse dell'infrastruttura quando aggiorni il tuo AWS SAM modello.

Il codice di un AWS::Serverless::WebFunction non viene controllato, perché ogni modifica al codice crea una nuova revisione. Le modifiche al codice vengono implementate con la successiva sincronizzazione dell'infrastruttura.

--watch-exclude TEXT

Esclude l'osservazione di un file o di una cartella per le modifiche ai file. Per utilizzare questa opzione, --watch deve essere fornito anche.

Questa opzione riceve una coppia chiave-valore:

  • Chiave — L'ID logico di una funzione Lambda nell'applicazione.

  • Valore — Il nome del file o la cartella associata da escludere.

Quando si aggiornano i file o le cartelle specificati con --watch-exclude opzione, AWS SAM CLI non avvierà una sincronizzazione. Tuttavia, quando un aggiornamento di altri file o cartelle avvia una sincronizzazione, tali file o cartelle verranno inclusi nella sincronizzazione.

È possibile fornire questa opzione più volte in un unico comando.

Esempi

Per esempi sull'utilizzo di questo comando, fare riferimento a Opzioni per il comando sam sync.