So passen Sie Starter-Pipelines an mit AWS SAM - AWS Serverless Application Model
BeispielprojekteBeispieldateien

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

So passen Sie Starter-Pipelines an mit AWS SAM

Als CI/CD-Administrator möchten Sie möglicherweise eine Vorlage für die Starter-Pipeline und die zugehörigen geführten Eingabeaufforderungen anpassen, anhand derer Entwickler in Ihrem Unternehmen Pipeline-Konfigurationen erstellen können.

Die AWS SAM CLI verwendet Cookiecutter-Vorlagen beim Erstellen von Starter-Vorlagen. Einzelheiten zu Vorlagen für Ausstechformen finden Sie unter Cookiecutter.

Sie können auch die Eingabeaufforderungen anpassen, die AWS SAM CLI wird Benutzern angezeigt, wenn sie Pipeline-Konfigurationen mit dem sam pipeline init Befehl erstellen. Gehen Sie wie folgt vor, um Benutzeraufforderungen anzupassen:

  1. questions.jsonDatei erstellen — Die questions.json Datei muss sich im Stammverzeichnis des Projekt-Repositorys befinden. Dies ist das gleiche Verzeichnis wie die Datei. cookiecutter.json Das Schema für die questions.json Datei finden Sie unter questions.json.schema. Eine Beispieldatei finden Sie unter questions.json. questions.json

  2. Zuordnen von Frageschlüsseln zu Cookiecutter-Namen — Jedes Objekt in der questions.json Datei benötigt einen Schlüssel, der einem Namen in der Cookiecutter-Vorlage entspricht. Dieser Schlüsselabgleich ist wie AWS SAM CLI ordnet die Antworten auf Benutzeraufforderungen der Cookie-Cutter-Vorlage zu. Beispiele für diese Tastenkombination finden Sie im Beispieldateien Abschnitt weiter unten in diesem Thema.

  3. metadata.jsonDatei erstellen — Geben Sie die Anzahl der Stufen an, die die Pipeline in der metadata.json Datei enthalten soll. Die Anzahl der Stufen gibt dem sam pipeline init Befehl an, für wie viele Stufen Informationen angefordert werden sollen, oder, im Fall der --bootstrap Option, für wie viele Stufen Infrastrukturressourcen erstellt werden sollen. Eine metadata.json Beispieldatei, die eine Pipeline mit zwei Stufen deklariert, finden Sie unter metadata.json.

Beispielprojekte

Hier sind Beispielprojekte, die jeweils eine Cookiecutter-Vorlage, eine questions.json Datei und eine metadata.json Datei enthalten:

Beispieldateien

Die folgenden Dateien zeigen, wie Fragen in der questions.json Datei mit Einträgen in der Cookiecutter-Vorlagendatei verknüpft sind. Beachten Sie, dass es sich bei diesen Beispielen um Dateifragmente und nicht um vollständige Dateien handelt. Beispiele für vollständige Dateien finden Sie im Beispielprojekte Abschnitt weiter oben in diesem Thema.

Beispiel questions.json:

{
  "questions": [{
    "key": "intro",
    "question": "\nThis template configures a pipeline that deploys a serverless application to a testing and a production stage.\n",
    "kind": "info"
  }, {
    "key": "pipeline_user_jenkins_credential_id",
    "question": "What is the Jenkins credential ID (via Jenkins plugin \"aws-credentials\") for pipeline user access key?",
    "isRequired": true
  }, {
    "key": "sam_template",
    "question": "What is the template file path?",
    "default": "template.yaml"
  }, {
    ...

Beispiel cookiecutter.json:

{
  "outputDir": "aws-sam-pipeline",
  "pipeline_user_jenkins_credential_id": "",
  "sam_template": "",
    ...

Beispiel Jenkinsfile:

pipeline {
  agent any
  environment {
    PIPELINE_USER_CREDENTIAL_ID = '{{cookiecutter.pipeline_user_jenkins_credential_id}}'
    SAM_TEMPLATE = '{{cookiecutter.sam_template}}'
    ...