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.
-
Para uma introdução ao AWS SAM CLI, veja O que é o AWS SAM CLI?
-
Para obter documentação sobre o uso do AWS SAM CLI
sam initcomando, veja Crie seu aplicativo em AWS SAM.
O comando sam init fornece opções para inicializar um novo aplicativo sem servidor.
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-templateTEXT-
O identificador do modelo de aplicativo gerenciado que você deseja usar. Se você não tiver certeza, chame
sam initsem opções para um fluxo de trabalho interativo.Esse parâmetro é obrigatório se
--no-interactivefor especificado e--locationnã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_64ouarm64. --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-interactivefor especificado,--package-typefor especificado comoImagee--locationnão for especificado. --config-envTEXT-
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-filePATH-
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.jsondo modelo, por exemplo,{"customParam1": "customValue1", "customParam2":"customValue2"}. --help, -h-
Mostra esta mensagem e sai.
--location, -lTEXT-
O modelo ou a localização do aplicativo (Git, Mercurial, HTTP/HTTPS, arquivo.zip, caminho).
Esse parâmetro é necessário se
--no-interactivefor especificado e--runtime,--name, e--app-templatenã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, -nTEXT-
O nome do seu projeto a ser gerado como um diretório.
Esse parâmetro é obrigatório se
--no-interactivefor especificado e--locationnã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, comosam build. Em caso de falha, inclui umerrorobjeto que descreve o que deu errado.notaO
--output jsona 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, -oPATH-
O local em que o aplicativo inicializado é gerado.
--package-type[ Zip | Image ]-
O tipo de pacote do aplicativo de exemplo.
Zipcria um arquivo .zip eImagecria 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-interactivefor especificado,--package-typefor especificado comoZipe--locationnã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.