View a markdown version of this page

bootstrap della pipeline 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à.

bootstrap della pipeline sam

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

Per un'introduzione al AWS SAM CLI, vedi Che cos'è il AWS SAM CLI?

Il sam pipeline bootstrap il sottocomando genera il richiesto AWS risorse di infrastruttura per connetterti al tuo CI/CD sistema. Questo passaggio deve essere eseguito per ogni fase di distribuzione della pipeline prima di eseguire sam pipeline init comando.

Questo sottocomando imposta quanto segue AWS risorse di infrastruttura:

  • Possibilità di configurare le autorizzazioni della pipeline tramite:

  • Un CloudFormation ruolo IAM di esecuzione assunto da CloudFormation per distribuire il AWS SAM applicazione.

  • Un bucket Amazon S3 per contenere AWS SAM artefatti.

  • Facoltativamente, un repository di immagini Amazon ECR per contenere i pacchetti di distribuzione Lambda di immagini dei contenitori (se disponi di una risorsa di tipo pacchetto) Image).

Importante

Non correre sam pipeline bootstrap con un file di configurazione non attendibile. Il provider OIDC del file e le impostazioni delle autorizzazioni determinano chi può assumere i ruoli IAM creati da questo comando.

Utilizzo

$ sam pipeline bootstrap <options>

Opzioni

--bitbucket-repo-uuid TEXT

L'UUID del repository Bitbucket. Questa opzione è specifica per l'utilizzo di Bitbucket OIDC per le autorizzazioni.

Nota

Questo valore può essere trovato in https://bitbucket.org/workspace/repository/admin/addon/admin/pipelines/openid-connect

--bucket TEXT

L'ARN del bucket Amazon S3 che contiene il AWS SAM artefatti.

--cicd-provider TEXT

Le CI/CD piattaforma per AWS SAM oleodotto.

--cloudformation-execution-role TEXT

L'ARN del ruolo IAM che deve essere assunto da CloudFormation durante la distribuzione dello stack dell'applicazione. Fornisci solo se desideri utilizzare il tuo ruolo. Altrimenti, il comando creerà un nuovo ruolo.

--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.

--confirm-changeset | --no-confirm-changeset

Chiedi di confermare l'utilizzo delle tue risorse.

--create-image-repository | --no-create-image-repository

Specifica se creare un repository di immagini Amazon ECR se non ne viene fornito uno. Il repository Amazon ECR contiene le immagini dei contenitori di Lambda Event Functions o i layer con un tipo di pacchetto di Image. Il valore predefinito è --no-create-image-repository.

--debug

Attiva la registrazione di debug e stampa i messaggi di debug che AWS SAM CLI genera e visualizza i timestamp.

--deployment-branch TEXT

Nome della filiale da cui verranno eseguite le distribuzioni. Questa opzione è specifica per l'utilizzo GitHub Azioni OIDC per le autorizzazioni.

--github-org TEXT

Le GitHub organizzazione a cui appartiene il repository. Se non esiste alcuna organizzazione, immettere il nome utente del proprietario del repository. Questa opzione è specifica per l'utilizzo GitHub Azioni OIDC per le autorizzazioni.

--github-repo TEXT

Nome del GitHub repository da cui verranno eseguite le distribuzioni. Questa opzione è specifica per l'utilizzo GitHub Azioni OIDC per le autorizzazioni.

--gitlab-group TEXT

Le GitLab gruppo a cui appartiene il repository. Questa opzione è specifica per l'utilizzo GitLab OIDC per le autorizzazioni.

--gitlab-project TEXT

L' GitLab nome del progetto. Questa opzione è specifica per l'uso GitLab OIDC per le autorizzazioni.

--help, -h

Mostra questo messaggio ed esce.

--image-repository TEXT

L'ARN di un repository di immagini Amazon ECR che contiene le immagini dei contenitori delle funzioni Lambda o i livelli con un tipo di pacchetto di Image. Se fornito, il --create-image-repository le opzioni vengono ignorate. Se non fornito e --create-image-repository è specificato, il comando ne crea uno.

--interactive | --no-interactive

Disabilita la richiesta interattiva per i parametri di bootstrap e fallisci se mancano i parametri richiesti. Il valore predefinito è --interactive. Per questo comando, --stage è l'unico parametro obbligatorio.

Nota

Se --no-interactive è specificato insieme a --use-oidc-provider, devono essere inclusi tutti i parametri richiesti per il provider OIDC.

--oidc-client-id TEXT

L'ID client configurato per l'uso con il tuo provider OIDC.

--oidc-provider [github-actions | gitlab | bitbucket-pipelines]

Nome del CI/CD provider che verrà utilizzato per le autorizzazioni OIDC. GitLab, GitHube Bitbucket sono supportati.

--oidc-provider-url TEXT

L'URL del provider OIDC. Il valore deve iniziare con https://.

--permissions-provider [oidc | iam]

Scegli un fornitore di autorizzazioni per assumere il ruolo di esecuzione della pipeline. Il valore predefinito è iam.

--pipeline-execution-role TEXT

L'ARN del ruolo IAM che deve essere assunto dall'utente della pipeline per operare in questa fase. Forniscilo solo se desideri utilizzare il tuo ruolo. Se non viene fornito, questo comando creerà un nuovo ruolo.

--pipeline-user TEXT

L'Amazon Resource Name (ARN) dell'utente IAM con l'ID della chiave di accesso e la chiave di accesso segreta condivisi con CI/CD sistema. Viene utilizzato per concedere a questo utente IAM l'autorizzazione ad accedere al corrispondente AWS account. Se non fornito, il comando creerà un utente IAM insieme all'ID della chiave di accesso e alle credenziali della chiave di accesso segreta.

--profile TEXT

Il profilo specifico del file delle credenziali che ottiene AWS credenziali.

--region TEXT

Le AWS Regione in cui effettuare la distribuzione. Ad esempio, us-east-1.

--save-params

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

--stage TEXT

Il nome della fase di distribuzione corrispondente. Viene utilizzato come suffisso per la creazione AWS risorse infrastrutturali.

Risoluzione dei problemi

Errore: parametro obbligatorio mancante

Quando --no-interactive è specificato insieme a --use-oidc-provider e uno qualsiasi dei parametri richiesti non viene fornito, questo messaggio di errore verrà visualizzato insieme a una descrizione dei parametri mancanti.

Esempio

L'esempio seguente crea AWS risorse necessarie per creare il tuo CI/CD sistema, attiva la registrazione di debug e stampa i messaggi di debug generati da AWS SAM CLI: utilizza un evento generato per i test locali utilizzando un s3.json evento per richiamare una funzione Lambda localmente

$ sam pipeline bootstrap --debug