AWS CloudFormation artefacts

CodePipeline exécute des tâches sur des artefacts comme CodePipeline exécute un pipeline. En effet AWS CloudFormation, les artefacts peuvent inclure un fichier de modèle de pile, un fichier de configuration de modèle, ou les deux. CodePipeline utilise ces artefacts pour travailler avec des AWS CloudFormation piles et des ensembles de modifications.

Si vous utilisez Amazon Simple Storage Service (Amazon S3) comme référentiel source, vous devez compresser le modèle et les fichiers de configuration du modèle dans un seul fichier avant de les charger dans un compartiment S3. Pour les autres référentiels, tels que GitHub et AWS CodeCommit, téléchargez des artefacts sans les compresser. Pour plus d'informations, voir Création d'un pipeline, d'étapes et d'actions dans le Guide de AWS CodePipeline l'utilisateur.

Vous pouvez ajouter autant de fichiers que nécessaire dans votre référentiel. Par exemple, vous pouvez inclure deux configurations différentes pour le même modèle : une configuration de test et une configuration de production.

Cette rubrique décrit chaque type d'artefact.

Fichier de modèle de pile

Un fichier de modèle de pile définit les ressources qui AWS CloudFormation provisionnent et configurent. Ces fichiers sont les mêmes modèles que ceux que vous utilisez lorsque vous créez ou mettez à jour des piles à l'aide AWS CloudFormation de. Vous pouvez utiliser YAML ou mettre en forme des JSON modèles. Pour plus d'informations sur les modèles, consultez CloudFormation sections du modèle.

Fichier de configuration de modèle

Un fichier de configuration de modèle est un fichier texte JSON formaté qui peut spécifier les valeurs des paramètres du modèle, une politique de pile et des balises. Utilisez ces fichiers de configuration pour spécifier les valeurs des paramètres ou une politique de pile pour une pile. Toutes les valeurs des paramètres que vous spécifiez doivent être déclarées dans le modèle associé.

Si vous incluez des informations sensibles (telles que des mots de passe) dans ce fichier, limitez l'accès à ce fichier. Par exemple, si vous chargez votre artefact dans un compartiment S3, utilisez des politiques de compartiment S3 ou des politiques utilisateur pour en limiter l'accès.

Pour créer un fichier de configuration, utilisez le format suivant :

{
  "Parameters" : {
    "NameOfTemplateParameter" : "ValueOfParameter",
    ...
  },
  "Tags" : {
    "TagKey" : "TagValue",
    ...
  }, 
  "StackPolicy" : {
    "Statement" : [
      StackPolicyStatement
    ]
  }
}

L'exemple suivant spécifie TestEC2Key comme paramètre KeyName, ajoute une balise Department dont la valeur est Marketing et ajoute une politique de pile qui permet toutes les actions de mise à jour, à l'exception d'une mise à jour qui supprimerait une ressource.

{
  "Parameters" : {
    "KeyName" : "TestEC2Key"
  },
  "Tags" : {
    "Department" : "Marketing"
  },
  "StackPolicy" : {
    "Statement" : [
      {
        "Effect" : "Allow",
        "NotAction" : "Update:Delete",
        "Principal": "*",
        "Resource" : "*"
      }
    ]
  }
}

Consultez aussi

Les ressources connexes suivantes peuvent s'avérer utiles lors de l'utilisation de ces paramètres.