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 utente IAM della pipeline con ID della chiave di accesso e credenziali di accesso con chiave segreta da condividere con CI/CD sistema.
NotaSi consiglia di ruotare regolarmente le chiavi di accesso. Per ulteriori informazioni, vedere Ruota regolarmente le chiavi di accesso per i casi d'uso che richiedono credenziali a lungo termine nel Guida per l'utente IAM.
-
Supportato CI/CD piattaforme tramite OIDC. Per un'introduzione all'uso di OIDC con AWS SAM pipeline, vai a Come utilizzare l'autenticazione OIDC con le pipeline AWS SAM.
-
-
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).
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-uuidTEXT-
L'UUID del repository Bitbucket. Questa opzione è specifica per l'utilizzo di Bitbucket OIDC per le autorizzazioni.
NotaQuesto valore può essere trovato in https://bitbucket.org/
workspace/repository/admin/addon/admin/pipelines/openid-connect --bucketTEXT-
L'ARN del bucket Amazon S3 che contiene il AWS SAM artefatti.
--cicd-providerTEXT-
Le CI/CD piattaforma per AWS SAM oleodotto.
--cloudformation-execution-roleTEXT-
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-envTEXT-
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-filePATH-
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è
samconfig.tomlnella 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-branchTEXT-
Nome della filiale da cui verranno eseguite le distribuzioni. Questa opzione è specifica per l'utilizzo GitHub Azioni OIDC per le autorizzazioni.
--github-orgTEXT-
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-repoTEXT-
Nome del GitHub repository da cui verranno eseguite le distribuzioni. Questa opzione è specifica per l'utilizzo GitHub Azioni OIDC per le autorizzazioni.
--gitlab-groupTEXT-
Le GitLab gruppo a cui appartiene il repository. Questa opzione è specifica per l'utilizzo GitLab OIDC per le autorizzazioni.
--gitlab-projectTEXT-
L' GitLab nome del progetto. Questa opzione è specifica per l'uso GitLab OIDC per le autorizzazioni.
--help, -h-
Mostra questo messaggio ed esce.
--image-repositoryTEXT-
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-repositoryle 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.NotaSe
--no-interactiveè specificato insieme a--use-oidc-provider, devono essere inclusi tutti i parametri richiesti per il provider OIDC. --oidc-client-idTEXT-
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-urlTEXT-
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-roleTEXT-
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-userTEXT-
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.
--profileTEXT-
Il profilo specifico del file delle credenziali che ottiene AWS credenziali.
--regionTEXT-
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.
--stageTEXT-
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