Stages und Tasks

Weitere Informationen über die Anpassung von Stufen mithilfe der Datei .pipeline-config.yaml finden Sie unter Benutzerdefinierte Skripte. e) und Pipelineparameter.

Parameter zum Konfigurieren von Terraform-Kontext und -Variablen

Für Terraform-Definitionen, die Infrastructure-as-Code-Quelle definieren, können der Kontext und die Variablen, die sich auf Terraform und Terraform-bezogene Scans und Prüfungen beziehen, mithilfe der in Tabelle 1 beschriebenen Parameter definiert werden.

Dieselben Parameter gelten für die Scripts, die in einem IaC CD-Implementierungsprozess verwendet werden. Da der CD-Prozess mehrere Bestandseinträge verarbeiten kann, können Sie einen Parameter für einen Bestandseintrag definieren. Um Terraform-Kontext und -Variablen für einen Bereich (Bestandseintrag) anzugeben, stellen Sie der Eigenschaft den Namen des Bestandseintrags voran, z. B. <inventory_entry>_. Dieses Präfix gilt für die Umgebungseinträge tf-dir, TF_VAR_<XXXX>, tfvars-repository, tfvars-branch und tfvars-files.

Beispiel:

hello-iac-sample_TF_VAR_resource_group : Default

Scans und Prüfungen Statischer Code-Scan

Die Stage 'Static Code Scan' führt eine Reihe von Analysetools für statischen Code in den angegebenen IaC-Repositorys aus. Die durch den Befehl pipelinectl save_repo angegebenen Repositorys und das Standard-App-Repository werden gescannt.

Sie können jede der Methoden verwenden, die für statische Code-Scans definiert sind, die für die Anwendung konfigurierbar sind, die sich auf die kontinuierliche Integrationspipeline beziehen.

Die IaC-Pipeline für kontinuierliche Integration definiert weitere Tools, die aktiviert werden, indem die opt-in-*-Parameter aus Tabelle 2 auf 1 gesetzt werden.

Scans und Prüfungen bei Compliance-Prüfungen

Konformitätsprüfungen, die für die anwendungsbezogene Pipeline für kontinuierliche Integration definiert sind, werden auch für die IaC-Pipeline für kontinuierliche Integration ausgeführt.

Die IaC-CI-Pipeline führt einige zusätzliche Prüfungen durch, die mithilfe von opt-in--Funktionen aktiviert werden.

Die IaC-CI-Pipeline definiert weitere Tools, die mithilfe der Parameter opt-in- aktiviert werden, die auf 1 gesetzt sind.

Diese Skripte werden auf allen Repos ausgeführt, die der Pipeline bekannt sind. Um Repos zu diesen Scans hinzuzufügen, verwenden Sie die Schnittstelle pipelinectl, die in Ihrer Einrichtungsphase bereitgestellt wird. Weitere Informationen finden Sie unter pipelinectl.

Weitere Informationen zu der erwarteten Ausgabe aus Benutzerscriptstages finden Sie in Angepasste Scripts.

{
    "scc_rules": [
        {
            "scc_rule_id": "rule-8cbd597c-7471-42bd-9c88-36b2696456e9"
        },
        {
            "scc_rule_id": "rule-c97259ee-336d-4c5f-b436-1868107a9558"
        }
    ]
}

Artefakt erstellen

In der Phase der Artefakterstellung können Sie Ihre eigenen Artefakte erstellen. Für die IaC-CI-Pipeline erstellt die Standardbuildfunktion eine TAR-Datei, die die Terraform-Konfiguration enthält.

Die Standardbuildfunktion kann mithilfe bestimmter Parameter aus Tabelle 5 konfiguriert werden.

Weitere Informationen dazu, wie Sie in Stages angepasster Scripts auf Parameter und geheime Schlüssel zugreifen, finden Sie unter Angepasste Scripts.

Artefaktsignierung

Die Stage 'Sign Artifact' stellt ein Standardverhalten für die Verwendung eines GPG-Schlüssels zum Erstellen einer freigegebenen Signaturdatei für ein oder mehrere Artefakte bereit.

Wenn Sie einen anderen Signierprozess verwenden wollen, passen Sie diese Stufe mithilfe der .pipeline-config.yaml-Konfiguration in Ihrem Projekt an.

In Entwicklung implementieren

Die Implementierungsphase implementiert das Konfigurationsartefakt in einer Entwicklungsumgebung. Sie können Ihre Variablen und Berechtigungsnachweise für diese Stage aus Variablen in der Pipeline-Benutzerschnittstelle und den Webhook-Nutzdaten für Pipeline-Auslöser angeben.

Die Scripts, die als Teil des Common Base Image bereitgestellt werden, können bei der Ausführung einer Implementierung mithilfe von Schemas oder der Terraform-CLI helfen. Die Parameter zum Konfigurieren der Scripts für die Implementierungsaktion werden in Tabelle 8 und Tabelle 9 beschrieben.

hello-iac-sample_schematics-workspace-name : workspace-for-deployment-of-hello-iac-sample

hello-iac-sample_tf-backend-s3-bucket : bucket-to-store-tfstate-of-hello-iac-sample

An Bestand freigeben

Verwenden Sie die Benutzerscript-Stage für die Freigabe an den Bestand, um Artefakte mithilfe des CLI-Befehls cocoa inventory add zum Bestand hinzuzufügen. Weitere Informationen zu cocoa inventory add finden Sie in Hinzufügen von Kakaobestand.

Sie können die Schnittstelle pipelinectl verwenden, um auf Ihre Repos und Artefakte zuzugreifen, indem Sie die Befehle list_repos, load_repo, list_artifacts und load_artifact verwenden. Weitere Informationen finden Sie unter pipelinectl.

Compliancedaten beim Buildvorgang erfassen

Wenn die Pipeline erfolgreich ausgeführt wird, können Sie Informationen zum Build erfassen.

Bei allen Kontrollen, Scans, Tests und Unterzeichnungen von Artefakten werden Beweise gesammelt und in der Asservatenkammer aufbewahrt. Die Protokolldateien der Pipeline werden zusammen mit den eigentlichen Pipelinedaten, die die Tekton-Definitionen enthalten, ebenfalls in diesem Schließfach gespeichert. Bei diesem Schritt werden auch Compliance-Daten zu Prüfungen durch Peers erfasst. Die Pipeline verwendet pipelinectl, um nach Repositorys mit Pull-Anforderungen zu suchen, die seit dem letzten Buildvorgang zusammengeführt wurden. Die Pipeline prüft auch den PR-Prüfungsstatus, speichert ihn als Artefakt und erstellt auf der Grundlage des Ergebnisses Nachweise.

Beim letzten Script handelt es sich um ein Auswertungsprogramm, das den Status der Pipeline abhängig von den Nachweisstatus grün oder rot kennzeichnet. Treten Fehler auf, wird der kontinuierliche Integrationslauf als rot markiert.