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.
-
Per un'introduzione al AWS SAM CLI, vedi Che cos'è il AWS SAM CLI?
-
Per la documentazione sull'uso di AWS SAM CLI, vedi AWS SAM CLI.
Il sam sync il comando sincronizza le modifiche dell'applicazione locale con Cloud AWS.
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, -sDIRECTORY-
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::FunctionProprietà:CodeUri -
Tipo di risorsa:
AWS::Serverless::FunctionAttributo della risorsa:MetadataInserimento:DockerContext -
Tipo di risorsa:
AWS::Serverless::LayerVersionProprietà:ContentUri -
Tipo di risorsa:
AWS::Lambda::FunctionProprietà:Code -
Tipo di risorsa:
AWS::Lambda::LayerVersionProprietà:Content
-
--build-imageTEXT-
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-imageamazon/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-imageFunction1=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-sourceper creare il progetto direttamente nella cartella sorgente.Il
--build-in-sourcel'opzione supporta i seguenti runtime e metodi di compilazione:-
Runtime — Qualsiasi Node.js runtime supportato da
sam init --runtimeopzione. -
Metodi di costruzione —
Makefile,esbuild.
Il
--build-in-sourcel'opzione non è compatibile con le seguenti opzioni:-
--use-container
Default:
--no-build-in-source -
--capabilitiesLIST-
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_IAMeCAPABILITY_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-envTEXT-
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-filePATH-
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::WebFunctionnon 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 predefiniteL'impostazione predefinita cambia in
--expressil 1° settembre 2026. --image-repositoryTEXT-
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
Imagetipo di pacchetto. --image-repositoriesTEXT-
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-repositoriesFunction1=123456789012.dkr.ecr.us-east-1.amazonaws.com/my-repoÈ possibile specificare questa opzione più volte in un unico comando.
--kms-key-idTEXT-
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-arnsLIST-
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
--resourceTEXT-
Specifica il tipo di risorsa da sincronizzare. Per sincronizzare più risorse, puoi specificare questa opzione più volte. Questa opzione è supportata con
--codeopzione. Il valore deve essere una delle risorse elencate in--code. Ad esempio,--resource AWS::Serverless::Function --resource AWS::Serverless::LayerVersion. --resource-idTEXT-
Specifica l'ID della risorsa da sincronizzare. Per sincronizzare più risorse, puoi specificare questa opzione più volte. Questa opzione è supportata con
--codeopzione. Ad esempio,--resource-id Function1 --resource-id Function2. --role-arnTEXT-
L'Amazon Resource Name (ARN) di un ruolo IAM che CloudFormation presuppone quando si applica il changeset.
--s3-bucketTEXT-
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-bucketo il--resolve-s3l'opzione è obbligatoria. Se si specificano entrambi--s3-buckete--resolve-s3opzioni, quindi si verifica un errore.Se si specifica questa opzione, il codice di un
AWS::Serverless::WebFunctionviene 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-prefixTEXT-
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
Ziptipo 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-syncper 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-syncper eseguire un CloudFormation distribuzione ogni voltasam syncviene eseguito.Per ulteriori informazioni, consulta Salta l'iniziale CloudFormation implementazione.
Default:
--skip-deploy-sync --stack-nameTEXT-
Il nome del CloudFormation stack per la tua applicazione.
Questa opzione è obbligatoria.
-
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, -tPATH-
Il percorso e il nome del file in cui si trova AWS SAM si trova il modello.
NotaSe 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.
NotaAttualmente, questa opzione non è compatibile con
--dependency-layer. Se usi--use-containercon--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::WebFunctionnon viene controllato, perché ogni modifica al codice crea una nuova revisione. Le modifiche al codice vengono implementate con la successiva sincronizzazione dell'infrastruttura. --watch-excludeTEXT-
Esclude l'osservazione di un file o di una cartella per le modifiche ai file. Per utilizzare questa opzione,
--watchdeve 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-excludeopzione, 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.