View a markdown version of this page

sam init - AWS Serverless Application Model

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

sam init

Esta página fornece informações de referência para o AWS Serverless Application Model Interface de linha de comando (AWS SAM CLI) sam init comando.

O comando sam init fornece opções para inicializar um novo aplicativo sem servidor.

Importante

Não use sam init com modelos de fontes não confiáveis. Um modelo personalizado, como aquele que você especifica com --location, pode executar ganchos em seu ambiente local durante a geração do projeto.

Usage

$ sam init <options>

Opções

--app-template TEXT

O identificador do modelo de aplicativo gerenciado que você deseja usar. Se você não tiver certeza, chame sam init sem opções para um fluxo de trabalho interativo.

Esse parâmetro é obrigatório se --no-interactive for especificado e --location não for fornecido.

Esse parâmetro só está disponível na versão 0.30.0 e posterior do AWS SAM CLI. A especificação desse parâmetro com uma versão anterior resulta em um erro.

--application-insights | --no-application-insights

Ative a Amazon CloudWatch Monitoramento do Application Insights para seu aplicativo. Para saber mais, consulte Usando o CloudWatch Application Insights para monitorar seus aplicativos AWS SAM sem servidor.

A opção padrão é --no-application-insights.

--architecture, -a [ x86_64 | arm64 ]

A arquitetura do conjunto de instruções para as funções de eventos do Lambda do seu aplicativo. Especifique um dos x86_64 ou arm64.

--base-image [ amazon/dotnet8-base | amazon/dotnet6-base | amazon/java25-base | amazon/java21-base | amazon/java17-base | amazon/java17.al2023-base | amazon/java11-base | amazon/java11.al2023-base | amazon/java8.al2023-base | amazon/nodejs26.x-base | amazon/nodejs24.x-base | amazon/nodejs22.x-base | amazon/nodejs20.x-base | amazon/nodejs18.x-base | amazon/nodejs16.x-base | amazon/python3.15-base | amazon/python3.14-base | amazon/python3.13-base | amazon/python3.12-base | amazon/python3.11-base | amazon/python3.10-base | amazon/python3.9-base | amazon/python3.8-base | amazon/ruby4.0-base | amazon/ruby3.4-base | amazon/ruby3.3-base | amazon/ruby3.2-base ]

A imagem base do seu aplicativo. Essa opção se aplica somente quando o tipo de pacote é Image.

Esse parâmetro é necessário se --no-interactive for especificado, --package-type for especificado como Image e --location não for especificado.

--config-env TEXT

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.

--config-file PATH

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.

--debug

Ativa o registro de depuração para imprimir as mensagens de depuração que o AWS SAM CLI gera e para exibir timestamps.

--dependency-manager, -d [ gradle | mod | maven | bundler | npm | cli-package | pip ]

O gerenciador de dependências do seu tempo de execução do Lambda.

--extra-content

Substitua quaisquer parâmetros personalizados na configuração cookiecutter.json do modelo, por exemplo, {"customParam1": "customValue1", "customParam2":"customValue2"}.

--help, -h

Mostra esta mensagem e sai.

--location, -l TEXT

O modelo ou a localização do aplicativo (Git, Mercurial, HTTP/HTTPS, arquivo.zip, caminho).

Esse parâmetro é necessário se --no-interactive for especificado e --runtime,--name, e --app-template não for fornecido.

Para repositórios Git, você deve usar a localização da raiz do repositório.

Para caminhos locais, o modelo deve estar no formato de arquivo.zip ou Cookiecutter.

--name, -n TEXT

O nome do seu projeto a ser gerado como um diretório.

Esse parâmetro é obrigatório se --no-interactive for especificado e --location não for fornecido.

--no-input

Desativa a solicitação do Cookiecutter e aceita os valores vcfdefault que são definidos na configuração do modelo.

--no-interactive

Desative a solicitação interativa para os parâmetros de inicialização e falha se algum valor necessário estiver ausente.

--output [ text | json ]

O formato da saída do comando:

  • text — Imprime saídas regulares e legíveis por humanos. Este é o valor padrão.

  • json — Imprime saídas estruturadas e legíveis por máquina. Use esse formato quando quiser consumir a saída programaticamente, como em CI/CD pipelines, extensões IDE e AI-assisted ferramentas.

Quando você especifica --output json, a AWS SAM CLI imprime um único objeto JSON após a conclusão do comando. Em caso de sucesso, esse objeto inclui campos como o diretório do projeto e o arquivo de modelo. Você pode encadear a saída em comandos subsequentes, como sam build. Em caso de falha, inclui um error objeto que descreve o que deu errado.

nota

O --output json a opção não é compatível com o fluxo de trabalho interativo. Para usá-lo, especifique uma execução totalmente não interativa fornecendo todas as opções necessárias.

--output-dir, -o PATH

O local em que o aplicativo inicializado é gerado.

--package-type [ Zip | Image ]

O tipo de pacote do aplicativo de exemplo. Zip cria um arquivo .zip e Image cria uma imagem de contêiner.

--runtime, -r [ dotnet8 | dotnet6 | java25 | java21 | java17 | java17.al2023 | java11 | java11.al2023 | java8.al2023 | nodejs26.x | nodejs24.x | nodejs22.x | nodejs20.x | nodejs18.x | nodejs16.x | python3.15 | python3.14 | python3.13 | python3.12 | python3.11 | python3.10 | python3.9 | python3.8 | ruby4.0 | ruby3.4 | ruby3.3 | ruby3.2 ]

O tempo de execução do Lambda do seu aplicativo. Essa opção se aplica somente quando o tipo de pacote é Zip.

Esse parâmetro é necessário se --no-interactive for especificado, --package-type for especificado como Zip e --location não for especificado.

--save-params

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

--tracing | --no-tracing

Ativar AWS X-Ray rastreamento para suas funções do Lambda.

Exemplo

Para obter um exemplo detalhado e uma explicação aprofundada sobre o uso do subcomando sam init, consulte Crie seu aplicativo em AWS SAM.