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à.
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 Come utilizzare l'autenticazione OIDC con le 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 SAMCLI 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 obbligatorio 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.