Riferimento all'azione di distribuzione di Amazon Elastic Container Service - AWS CodePipeline
Tipo di operazioneParametri di configurazione Input artifact (Artefatti di input)Artefatti di outputDichiarazione dell'operazioneConsulta anche

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 di distribuzione di Amazon Elastic Container Service

Puoi utilizzare un'ECSazione Amazon per distribuire un ECS servizio Amazon e un set di attività. Un ECS servizio Amazon è un'applicazione contenitore che viene distribuita in un ECS cluster Amazon. Un ECS cluster Amazon è una raccolta di istanze che ospitano l'applicazione container nel cloud. La distribuzione richiede una definizione di attività creata in Amazon ECS e un file di definizioni delle immagini da CodePipeline utilizzare per distribuire l'immagine.

Importante

L'azione di distribuzione ECS standard di Amazon CodePipeline crea la propria revisione della definizione dell'attività in base alla revisione utilizzata dal servizio AmazonECS. Se crei nuove revisioni per la definizione dell'attività senza aggiornare il ECS servizio Amazon, l'azione di distribuzione ignorerà tali revisioni.

Prima di creare la tua pipeline, devi aver già creato le ECS risorse Amazon, taggato e archiviato l'immagine nel tuo repository di immagini e caricato il BuildSpec file nel tuo archivio di file.

Nota

Questo argomento di riferimento descrive l'azione di distribuzione ECS standard di Amazon per CodePipeline. Per informazioni di riferimento sulle azioni di distribuzione ECS di Amazon to CodeDeploy blue/green in CodePipeline, consulta. Riferimento alle azioni di distribuzione di Amazon Elastic Container Service e CodeDeploy blue-green

Tipo di operazione

  • Categoria: Deploy

  • Proprietario: AWS

  • Provider: ECS

  • Versione: 1

Parametri di configurazione

ClusterName

Campo obbligatorio: sì

Il ECS cluster Amazon in AmazonECS.

ServiceName

Campo obbligatorio: sì

Il ECS servizio Amazon che hai creato in AmazonECS.

FileName

Campo obbligatorio: no

Il nome del file di definizioni delle immagini, il JSON file che descrive il nome del contenitore del servizio, l'immagine e il tag. Questo file viene utilizzato per le distribuzioni ECS standard. Per ulteriori informazioni, consulta Input artifact (Artefatti di input) e file imagedefinitions.json per le azioni di distribuzione standard di Amazon ECS.

DeploymentTimeout

Campo obbligatorio: no

Il timeout dell'azione di ECS distribuzione di Amazon in minuti. Il timeout è configurabile fino al timeout predefinito massimo per questa operazione. Per esempio: 

"DeploymentTimeout": "15"

Input artifact (Artefatti di input)

  • Numero di artefatti: 1

  • Descrizione: l'azione cerca un imagedefinitions.json file nell'archivio dei file di origine della pipeline. Un documento di definizione delle immagini è un JSON file che descrive il nome del ECS contenitore Amazon, l'immagine e il tag. CodePipeline utilizza il file per recuperare l'immagine dal tuo archivio di immagini come Amazon. ECR Puoi aggiungere manualmente un imagedefinitions.json file per una pipeline in cui l'azione non è automatizzata. Per ulteriori informazioni sul file imagedefinitions.json, consulta file imagedefinitions.json per le azioni di distribuzione standard di Amazon ECS.

    L'azione richiede un'immagine esistente che è già stata inserita nel tuo archivio di immagini. Poiché la mappatura delle immagini è fornita dal imagedefinitions.json file, l'azione non richiede che il ECR codice sorgente Amazon sia incluso come azione sorgente nella pipeline.

Artefatti di output

  • Numero di artefatti: 0

  • Descrizione: gli artefatti di output non si applicano a questo tipo di azione.

Dichiarazione dell'operazione

YAML
Name: DeployECS
ActionTypeId:
  Category: Deploy
  Owner: AWS
  Provider: ECS
  Version: '1'
RunOrder: 2
Configuration:
  ClusterName: my-ecs-cluster
  ServiceName: sample-app-service
  FileName: imagedefinitions.json
  DeploymentTimeout: '15'
OutputArtifacts: []
InputArtifacts:
  - Name: my-image
JSON
{
    "Name": "DeployECS",
    "ActionTypeId": {
        "Category": "Deploy",
        "Owner": "AWS",
        "Provider": "ECS",
        "Version": "1"
    },
    "RunOrder": 2,
    "Configuration": {
        "ClusterName": "my-ecs-cluster",
        "ServiceName": "sample-app-service",
        "FileName": "imagedefinitions.json",
        "DeploymentTimeout": "15"
    },
    "OutputArtifacts": [],
    "InputArtifacts": [
        {
            "Name": "my-image"
        }
    ]
},

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

  • Tutorial: distribuzione continua con CodePipeline: questo tutorial mostra come creare un Dockerfile da archiviare in un repository di file sorgente come. CodeCommit Successivamente, il tutorial mostra come incorporare un CodeBuild BuildSpec file che crea e invia la tua immagine Docker su Amazon ECR e crea il tuo file imagedefinitions.json. Infine, crei una definizione di ECS servizio e attività Amazon, quindi crei la tua pipeline con un'azione di ECS distribuzione Amazon.

    Nota

    Questo argomento e questo tutorial descrivono l'azione di distribuzione ECS standard di Amazon per CodePipeline. Per informazioni sulle azioni di distribuzione ECS di Amazon to CodeDeploy blue/green in CodePipeline, consulta. Tutorial: crea una pipeline con un ECR codice sorgente Amazon e la ECS relativa distribuzione CodeDeploy

  • Guida per sviluppatori di Amazon Elastic Container Service: per informazioni sull'utilizzo di immagini e contenitori Docker, ECS servizi e cluster Amazon e set di ECS attività Amazon, consulta What Is Amazon? ECS