sam pipeline bootstrap

Questa pagina fornisce informazioni di riferimento per il AWS Serverless Application Model sam local pipeline bootstrap sottocomando Command Line Interface (AWS SAMCLI).

Per un'introduzione a AWS SAMCLI, vedereChe cos'è il? AWS SAMCLI.

Il sam pipeline bootstrap sottocomando genera le risorse di AWS infrastruttura necessarie per connettersi al sistema CI/CD. Questo passaggio deve essere eseguito per ogni fase di distribuzione nella pipeline prima di eseguire il comando. sam pipeline init

Questo sottocomando imposta le seguenti risorse di AWS infrastruttura:

• Possibilità di configurare le autorizzazioni della pipeline tramite:

  • Un utente IAM della pipeline con ID della chiave di accesso e credenziali di accesso alla chiave segreta da condividere con il sistema CI/CD.

    Nota

    Consigliamo di ruotare le chiavi di accesso regolarmente. Per ulteriori informazioni, consulta Ruotare regolarmente le chiavi di accesso per i casi d'uso che richiedono credenziali a lungo termine nella Guida per l'utente IAM.

  • Piattaforme CI/CD supportate tramite OIDC. Per un'introduzione all'uso di OIDC con pipeline, vai a. AWS SAM Utilizzo dell'autenticazione OIDC con pipeline AWS SAM

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

• Un bucket Amazon S3 per contenere gli artefatti. AWS SAM

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

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 è disponibile all'indirizzo https://bitbucket.org/ workspace/repository /admin/addon/admin/pipelines/openid-connect

--bucket TEXT

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

--cicd-provider TEXT

La piattaforma CI/CD per la pipeline. AWS SAM

--cloudformation-execution-role TEXT

L'ARN del ruolo IAM da assumere AWS CloudFormation durante la distribuzione dello stack dell'applicazione. Forniscilo 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 si trova samconfig.toml nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta AWS SAMCLIfile di configurazione.

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

Richiedi di confermare la distribuzione delle tue risorse.

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

Specificare se creare un repository di immagini Amazon ECR se non ne viene fornito nessuno. Il repository Amazon ECR contiene le immagini del contenitore delle funzioni Lambda o dei livelli 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 del ramo da cui verranno effettuate le distribuzioni. Questa opzione è specifica per l'utilizzo di GitHub Actions OIDC per le autorizzazioni.

--github-org TEXT

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

--github-repo TEXT

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

--gitlab-group TEXT

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

--gitlab-project TEXT

Il GitLab nome del progetto. Questa opzione è specifica per l'utilizzo di 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 del contenitore di funzioni Lambda o livelli con un tipo di pacchetto di. Image Se fornite, le opzioni vengono ignorate. --create-image-repository Se non viene fornito e --create-image-repository viene specificato, il comando ne crea una.

--interactive | --no-interactive

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

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

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

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

--oidc-provider-url TEXT

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

--permissions-provider [oidc | iam]

Scegliete 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 l'utente della pipeline deve assumere per operare in questa fase. Forniscilo solo se desideri utilizzare il tuo ruolo. Se non 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 il sistema CI/CD. Viene utilizzato per concedere a questo utente IAM l'autorizzazione ad accedere all'account corrispondente. AWS Se non viene 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 di credenziali che ottiene AWS le credenziali.

--region TEXT

La AWS regione in cui effettuare la distribuzione. Ad esempio, us-east-1.

--save-params

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

--stage TEXT

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

Risoluzione dei problemi

Errore: parametro richiesto mancante

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