Riferimento all'azione dei comandi - AWS CodePipeline

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

Riferimento all'azione dei comandi

L'azione Comandi consente di eseguire comandi shell in un'istanza di calcolo virtuale. Quando si esegue l'azione, i comandi specificati nella configurazione dell'azione vengono eseguiti in un contenitore separato. Tutti gli artefatti specificati come artefatti di input per un' CodeBuild azione sono disponibili all'interno del contenitore che esegue i comandi. Questa azione consente di specificare i comandi senza prima creare un progetto. CodeBuild Per ulteriori informazioni, vedere ActionDeclaratione OutputArtifactnel AWS CodePipeline APIReference.

Considerazioni sull'azione Comandi

Le considerazioni seguenti si applicano all'azione Comandi.

  • L'azione dei comandi utilizza CodeBuild risorse simili all' CodeBuild azione, ma consente i comandi in ambiente shell in un'istanza di calcolo virtuale senza la necessità di associare o creare un progetto di compilazione.

    Nota

    L'esecuzione dell'azione dei comandi comporterà costi separati in. AWS CodeBuild

  • Poiché l'azione Comandi in CodePipeline utilizza CodeBuild risorse, le build eseguite dall'azione verranno attribuite ai limiti di build per il tuo account in. CodeBuild Le build eseguite dall'azione Comandi verranno conteggiate ai fini dei limiti di compilazione simultanea configurati per quell'account.

  • Il timeout per le build con l'azione Comandi è di 55 minuti, in base alle build. CodeBuild

  • L'istanza di calcolo utilizza un ambiente di compilazione isolato in. CodeBuild

    Nota

    Poiché l'ambiente di compilazione isolato viene utilizzato a livello di account, un'istanza potrebbe essere riutilizzata per un'altra esecuzione della pipeline.

  • Sono supportati tutti i formati tranne i formati multilinea. È necessario utilizzare il formato a riga singola quando si immettono i comandi.

  • L'azione dei comandi non è supportata per le azioni tra account o tra aree geografiche.

  • Per questa azione, CodePipeline assumerà il ruolo di servizio di pipeline e utilizzerà tale ruolo per consentire l'accesso alle risorse in fase di esecuzione. Si consiglia di configurare il ruolo di servizio in modo che le autorizzazioni siano limitate al livello di azione.

  • Le autorizzazioni aggiunte al ruolo di CodePipeline servizio sono dettagliate in. Aggiunta delle autorizzazioni dal ruolo di servizio CodePipeline

  • Le autorizzazioni necessarie per visualizzare i log nella console sono dettagliate in. Autorizzazioni necessarie per visualizzare i registri di calcolo nella console CodePipeline

  • A differenza di altre azioni in CodePipeline, non si impostano campi nella configurazione dell'azione; si impostano i campi di configurazione dell'azione al di fuori della configurazione dell'azione.

Autorizzazioni relative ai ruoli di servizio

Quando CodePipeline esegue l'azione, CodePipeline crea un gruppo di log utilizzando il nome della pipeline come segue. Ciò consente di ridurre l'ambito delle autorizzazioni per registrare le risorse utilizzando il nome della pipeline.

/aws/codepipeline/MyPipelineName

Se si utilizza un ruolo di servizio esistente, per utilizzare l'azione Comandi è necessario aggiungere le seguenti autorizzazioni per il ruolo di servizio.

  • registri: CreateLogGroup

  • registri: CreateLogStream

  • registri: PutLogEvents

Nella dichiarazione sulla politica relativa al ruolo del servizio, riduci le autorizzazioni a livello di pipeline, come mostrato nell'esempio seguente.

{ "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:CreateLogStream", "logs:PutLogEvents" ], "Resource": "arn:aws:logs:*:YOUR_AWS_ACCOUNT_ID:log-group:/aws/codepipeline/YOUR_PIPELINE_NAME:*" }

Per visualizzare i log nella console utilizzando la pagina di dialogo dei dettagli delle azioni, è necessario aggiungere l'autorizzazione alla visualizzazione dei log al ruolo della console. Per ulteriori informazioni, consulta l'esempio di policy sulle autorizzazioni della console in. Autorizzazioni necessarie per visualizzare i registri di calcolo nella console CodePipeline

Tipo di operazione

  • Categoria: Compute

  • Proprietario: AWS

  • Provider: Commands

  • Versione: 1

Parametri di configurazione

Comandi

Campo obbligatorio: sì

È possibile fornire comandi di shell per l'Commandsazione da eseguire. Nella console, i comandi vengono immessi su righe separate. NellaCLI, i comandi vengono immessi come stringhe separate.

Nota

I formati multilinea non sono supportati e genereranno un messaggio di errore. È necessario utilizzare il formato a riga singola per immettere i comandi nel campo Comandi.

I seguenti dettagli forniscono il calcolo predefinito utilizzato per l'azione Comandi. Per ulteriori informazioni, consulta il riferimento ai metodi e ai tipi di calcolo dell'ambiente di compilazione nella Guida per l' CodeBuildutente.

  • CodeBuild immagine: 2-x86_64-standard:5.0 aws/codebuild/amazonlinux

  • Tipo di calcolo: Linux Small

  • computeType Valore dell'ambiente: BUILD _ _ GENERAL1 SMALL

  • Valore del tipo di ambiente: LINUX _ CONTAINER

outputVariables

Campo obbligatorio: no

Specificate i nomi delle variabili dell'ambiente che desiderate esportare. Per un riferimento alle variabili di CodeBuild ambiente, consulta Variabili di ambiente negli ambienti di compilazione nella Guida CodeBuild per l'utente.

File

Campo obbligatorio: no

Potete fornire i file che desiderate esportare come artefatti di output per l'azione.

Il formato supportato per i file è lo stesso dei modelli di CodeBuild file. Ad esempio, immettere **/ per tutti i file. Per ulteriori informazioni, consulta il riferimento alle specifiche di Build CodeBuild nella Guida per l'CodeBuild utente.

La pagina Modifica azione per una nuova pipeline con l'azione Comandi

Input artifact (Artefatti di input)

  • Numero di artefatti: 1 to 10

Artefatti di output

  • Numero di artefatti: 0 to 1

Dichiarazione di azione (esempio)

YAML
name: Commands_action actionTypeId: category: Compute owner: AWS provider: Commands version: '1' runOrder: 1 configuration: {} commands: - ls - echo hello - 'echo pipeline Execution Id is #{codepipeline.PipelineExecutionId}' outputArtifacts: - name: BuildArtifact files: - **/ inputArtifacts: - name: SourceArtifact outputVariables: - AWS_DEFAULT_REGION region: us-east-1 namespace: compute
JSON
{ "name": "Commands_action", "actionTypeId": { "category": "Compute", "owner": "AWS", "provider": "Commands", "version": "1" }, "runOrder": 1, "configuration": {}, "commands": [ "ls", "echo hello", "echo pipeline Execution Id is #{codepipeline.PipelineExecutionId}" ], "outputArtifacts": [ { "name": "BuildArtifact", "files": [ "**/" ] } ], "inputArtifacts": [ { "name": "SourceArtifact" } ], "outputVariables": [ "AWS_DEFAULT_REGION" ], "region": "us-east-1", "namespace": "compute" }

Le risorse correlate seguenti possono essere utili durante l'utilizzo di questa operazione.