sam sync

Resolve caminhos relativos para o código-fonte da função ou da camada em relação a esse diretório. Use essa opção para alterar a forma como os caminhos relativos para as pastas de código-fonte são resolvidos. Por padrão, os caminhos relativos são resolvidos com relação à localização do AWS SAM modelo.

Além dos recursos no aplicativo raiz ou na pilha que você está criando, essa opção também se aplica a aplicativos ou pilhas aninhados. Além disso, essa opção se aplica aos seguintes tipos e propriedades de recursos:

O URI da imagem do contêiner que você deseja usar ao criar o aplicativo. Por padrão, AWS SAM usa o URI do repositório de imagens de contêiner do Amazon Elastic Container Registry (Amazon ECR) Public. Especifique essa opção para usar uma imagem diferente.

Você pode usar essa opção várias vezes em um único comando. Cada opção aceita uma sequência ou um par de chave/valor.

Essa opção só se aplica se a opção --use-container for especificada, caso contrário, ocorrerá um erro.

Providencie --build-in-source para compilar seu projeto diretamente na pasta de origem.

A opção --build-in-source oferece suporte aos seguintes runtimes e métodos de compilação:

A opção --build-in-source não é compatível com as seguintes opções:

Padrão: --no-build-in-source

Uma lista de recursos que você especifica para permitir CloudFormation a criação de determinadas pilhas. Alguns modelos de pilha podem incluir recursos que podem afetar as permissões em seu Conta da AWS. Por exemplo, criando novos usuários AWS Identity and Access Management (IAM). Especifique essa opção para substituir os valores padrão. Os valores válidos incluem:

Padrão: CAPABILITY_NAMED_IAM e CAPABILITY_AUTO_EXPAND

Por padrão, AWS SAM sincroniza todos os recursos em seu aplicativo. Especifique essa opção para sincronizar somente recursos de código, que incluem o seguinte:

Para sincronizar recursos de código, AWS SAM usa o AWS serviço APIs diretamente, em vez de implantar por meio AWS CloudFormation de. Para atualizar sua CloudFormation pilha, execute sam sync --watch ousam deploy.

O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados. O valor padrão é “padrão”. Para obter mais informações sobre esses arquivos de configuração, consulte Arquivo de configuração do AWS SAM CLI.

O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados. O valor padrão é “samconfig.toml“ na raiz do diretório do projeto. Para obter mais informações sobre esses arquivos de configuração, consulte Arquivo de configuração do AWS SAM CLI.

Especifica se as dependências de funções individuais devem ser separadas em outra camada para acelerar o processo de sincronização.

Padrão: --dependency-layer

O nome do repositório do Amazon Elastic Container Registry (Amazon ECR) no qual esse comando faz upload da imagem da função. Necessário para funções declaradas com o tipo de pacote Image.

Um mapeamento de funções para o URI do repositório Amazon ECR. Funções de referência por meio de sua ID lógica. Veja um exemplo a seguir:

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

Você pode especificar esta opção várias vezes em um único comando.

O ID de uma chave AWS Key Management Service (AWS KMS) usada para criptografar artefatos que estão em repouso no bucket do Amazon S3. Se você não especificar essa opção, AWS SAM use as chaves de criptografia gerenciadas pelo Amazon S3.

Um mapa de metadados para anexar a todos os artefatos que você faz referência no seu modelo.

Uma lista dos ARNs tópicos CloudFormation do Amazon Simple Notification Service (Amazon SNS) associados à pilha.

Uma opção que permite usar o kit de ferramentas do IDE para definir o comportamento padrão.

Uma string que contém substituições de CloudFormation parâmetros codificadas como pares de valores-chave. Use o mesmo formato do AWS Command Line Interface (AWS CLI). O formato da CLI do AWS SAMé uma palavra-chave explícita de chave e valor e cada substituição é separada por um espaço. Veja dois exemplos a seguir:

Especifica o tipo de recurso a ser sincronizado. Para sincronizar vários recursos, você pode especificar essa opção várias vezes. Essa opção é compatível com a opção --code. O valor deve ser um dos recursos listados em --code. Por exemplo, .--resource AWS::Serverless::Function --resource AWS::Serverless::LayerVersion

Especifica o ID do recurso a ser sincronizado. Para sincronizar vários recursos, você pode especificar essa opção várias vezes. Essa opção é compatível com a opção --code. Por exemplo, .--resource-id Function1 --resource-id Function2

O Amazon Resource Name (ARN) de uma função do IAM que é CloudFormation assumida ao aplicar o conjunto de alterações.

O nome do bucket do Amazon Simple Storage Service (Amazon S3) no qual esse comando carrega seu modelo. CloudFormation Se seu modelo for maior que 51.200 bytes, a opção --s3-bucket ou a opção --resolve-s3 serão obrigatórias. Se você especificar as opções --s3-bucket e --resolve-s3, ocorrerá um erro.

O prefixo adicionado aos nomes dos artefatos que você faz upload para o bucket do Amazon S3. O nome do prefixo é um nome de caminho (nome da pasta) para o bucket do Amazon S3. Isso se aplica somente às funções declaradas com o tipo de pacote Zip.

Salva os parâmetros que você fornece na linha de comando no arquivo AWS SAM de configuração.

Especifica --skip-deploy-sync para ignorar a sincronização inicial da infraestrutura se ela não for necessária. Ele AWS SAMCLI comparará seu AWS SAM modelo local com o CloudFormation modelo implantado e executará uma implantação somente se uma alteração for detectada.

Especifica --no-skip-deploy-sync a realização de uma CloudFormation implantação sempre que sam sync for executada.

Para saber mais, consulte Ignore a implantação inicial CloudFormation.

Padrão: --skip-deploy-sync

O nome da CloudFormation pilha do seu aplicativo.

Essa opção é obrigatória.

Uma lista de tags a serem associadas à pilha criada ou atualizada. CloudFormation também propaga essas tags para recursos na pilha que as suportam.

O caminho e o nome do arquivo em que seu AWS SAM modelo está localizado.

Se suas funções dependerem de pacotes que tenham dependências compiladas de forma nativa, use essa opção para criar sua função dentro de um contêiner AWS Lambda semelhante Docker a.

Inicia um processo que monitora o aplicativo local em busca de alterações e as sincroniza automaticamente com o. Nuvem AWS Por padrão, quando você especifica essa opção, AWS SAM sincroniza todos os recursos em seu aplicativo à medida que você os atualiza. Com essa opção, AWS SAM executa uma CloudFormation implantação inicial. Em seguida, AWS SAM usa o AWS serviço APIs para atualizar os recursos de código. AWS SAM usa CloudFormation para atualizar recursos de infraestrutura quando você atualiza seu AWS SAM modelo.

Exclui um arquivo ou pasta da observação de alterações no arquivo. Para usar essa opção, --watch deverá ser fornecido.

Cada opção recebe um par de valores-chave:

Quando você atualiza quaisquer arquivos ou pastas especificados com a --watch-exclude opção, AWS SAM CLI eles não iniciarão uma sincronização. No entanto, quando uma atualização de outros arquivos ou pastas inicia uma sincronização, esses arquivos ou pastas serão incluídos nessa sincronização.

Você pode fornecer essa opção várias vezes em um único comando.