Référence d'action source Amazon S3

Déclenche le pipeline lorsqu'un nouvel objet est chargé dans le compartiment et la clé d'objet configurés.

Note

Cette rubrique de référence décrit l'action relative à la source Amazon S3 CodePipeline lorsque l'emplacement source est un compartiment Amazon S3 configuré pour le versionnement. Pour des informations de référence sur l'action de déploiement d'Amazon S3 dans CodePipeline, consultezRéférence des actions de déploiement d'Amazon S3.

Vous pouvez créer un compartiment Amazon S3 à utiliser comme emplacement source pour les fichiers de votre application.

Note

Lorsque vous créez votre compartiment source, assurez-vous d'activer la gestion des versions sur le compartiment. Si vous souhaitez utiliser un compartiment Amazon S3 existant, consultez Utiliser le contrôle de version pour activer le contrôle de version sur un compartiment existant.

Si vous utilisez la console pour créer ou modifier votre pipeline, CodePipeline crée une règle d' CloudWatch événements qui démarre votre pipeline lorsqu'une modification se produit dans le compartiment source S3.

Vous devez déjà avoir créé un compartiment source Amazon S3 et téléchargé les fichiers source sous forme de ZIP fichier unique avant de connecter le pipeline via une action Amazon S3.

Note

Lorsque Amazon S3 est le fournisseur source de votre pipeline, vous pouvez compresser votre ou vos fichiers source dans un seul fichier .zip et télécharger le fichier .zip dans votre compartiment source. Vous pouvez également charger un seul fichier décompressé ; toutefois, les actions en aval qui attendent un fichier .zip échoueront.

Type d'action

• Catégorie : Source

• Propriétaire : AWS

• Fournisseur : S3

• Version : 1

Paramètres de configuration

S3Bucket

Obligatoire : oui

Nom du compartiment Amazon S3 dans lequel les modifications de source doivent être détectées.

S3 ObjectKey

Obligatoire : oui

Le nom de la clé d'objet Amazon S3 dans laquelle les modifications de source doivent être détectées.

AllowOverrideForS3 ObjectKey

Obligatoire : non

AllowOverrideForS3ObjectKeycontrôle si les remplacements de source StartPipelineExecution peuvent remplacer ceux déjà configurés S3ObjectKey dans l'action source. Pour plus d'informations sur les remplacements de source avec la clé d'objet S3, consultezDémarrer un pipeline avec une modification de version source.

Important

Si vous omettezAllowOverrideForS3ObjectKey, la possibilité CodePipeline par défaut de remplacer le S3 ObjectKey dans l'action source en définissant ce paramètre sur. false

Valeurs valides pour ce paramètre :

• true: Si elle est définie, la clé d'objet S3 préconfigurée peut être remplacée par des remplacements de version source lors de l'exécution d'un pipeline.

  Note

  Si vous avez l'intention de permettre à tous les CodePipeline utilisateurs de remplacer la clé d'objet S3 préconfigurée lors du démarrage d'une nouvelle exécution de pipeline, vous devez définir surAllowOverrideForS3ObjectKey. true

• false:

  Si elle est définie, elle n' CodePipeline autorisera pas le remplacement de la clé d'objet S3 à l'aide de remplacements de version source. Il s'agit également de la valeur par défaut de ce paramètre.

PollForSourceChanges

Obligatoire : non

PollForSourceChangescontrôle si le compartiment source Amazon S3 CodePipeline interroge les modifications de source. Nous vous recommandons plutôt d'utiliser CloudWatch Events et CloudTrail de détecter les modifications de source. Pour plus d'informations sur la configuration CloudWatch des événements, consultez Migrer les pipelines de sondage avec une source et un CloudTrail trail S3 (CLI) ouMigrer les pipelines de sondage avec une source et un CloudTrail suivi S3 (AWS CloudFormation modèle).

Important

Si vous avez l'intention de configurer les CloudWatch événements, vous devez définir sur PollForSourceChanges pour false éviter les exécutions de pipeline dupliquées.

Valeurs valides pour ce paramètre :

• true: si cette option est définie, CodePipeline interroge l'emplacement de votre source pour connaître les modifications apportées à la source.

  Note

  Si vous omettezPollForSourceChanges, CodePipeline par défaut, l'emplacement de votre source est interrogé pour connaître les modifications apportées à la source. Ce comportement est le même que si PollForSourceChanges est inclus et défini sur true.

• false: si cette option est définie, CodePipeline il n'interroge pas l'emplacement de votre source pour connaître les modifications apportées à la source. Utilisez ce paramètre si vous avez l'intention de configurer une règle d' CloudWatch événements pour détecter les modifications de source.

Artefacts d'entrée

• Nombre d'artefacts : 0

• Description : Les artefacts d'entrée ne s'appliquent pas à ce type d'action.

Artefacts de sortie

• Nombre d'objets : 1

• Description : Fournit les artefacts disponibles dans le compartiment source configuré pour se connecter au pipeline. Les artefacts générés par le compartiment sont les artefacts de sortie pour l'action Amazon S3. Les métadonnées de l'objet Amazon S3 (ETaget l'ID de version) sont affichées en CodePipeline tant que révision source pour l'exécution du pipeline déclenchée.

Variables de sortie

Lorsque cette action est configurée, elle produit des variables qui peuvent être référencées par la configuration d'action d'une action en aval dans le pipeline. Cette action produit des variables qui peuvent être visualisées en tant que variables de sortie, même si l'action n'a pas d'espace de noms. Vous configurez une action avec un espace de noms pour rendre ces variables disponibles pour la configuration des actions en aval.

Pour plus d'informations sur les variables dans CodePipeline, consultezRéférence aux variables.

BucketName

Le nom du compartiment Amazon S3 associé à la modification de source qui a déclenché le pipeline.

ETag

Balise d'entité de l'objet lié à la modification de la source ayant déclenché le pipeline. ETagIl s'agit d'un MD5 hachage de l'objet. ETagreflète uniquement les modifications apportées au contenu d'un objet, et non à ses métadonnées.

ObjectKey

Le nom de la clé d'objet Amazon S3 associée à la modification de source qui a déclenché le pipeline.

VersionId

ID de version de la version de l'objet lié à la modification de la source ayant déclenché le pipeline.

Déclaration d'action

YAML

Name: Source
Actions:
  - RunOrder: 1
    OutputArtifacts:
      - Name: SourceArtifact
    ActionTypeId:
      Provider: S3
      Owner: AWS
      Version: '1'
      Category: Source
    Region: us-west-2
    Name: Source
    Configuration:
      S3Bucket: amzn-s3-demo-source-bucket
      S3ObjectKey: my-application.zip
      PollForSourceChanges: 'false'
    InputArtifacts: []

JSON

{
    "Name": "Source",
    "Actions": [
        {
            "RunOrder": 1,
            "OutputArtifacts": [
                {
                    "Name": "SourceArtifact"
                }
            ],
            "ActionTypeId": {
                "Provider": "S3",
                "Owner": "AWS",
                "Version": "1",
                "Category": "Source"
            },
            "Region": "us-west-2",
            "Name": "Source",
            "Configuration": {
                "S3Bucket": "amzn-s3-demo-source-bucket",
                "S3ObjectKey": "my-application.zip",
                "PollForSourceChanges": "false"
            },
            "InputArtifacts": []
        }
    ]
},

Consultez aussi

Les ressources connexes suivantes peuvent s'avérer utiles dans le cadre de l'utilisation de cette action.

• Didacticiel : Création d'un pipeline simple (compartiment S3)— Ce didacticiel fournit un exemple de fichier de spécifications d'application, un exemple d' CodeDeployapplication et un groupe de déploiement. Utilisez ce didacticiel pour créer un pipeline avec une source Amazon S3 qui se déploie sur des EC2 instances Amazon.