DevSecOps Obligatorische und optionale Variablen für das Application Lifecycle Management
Verwenden Sie die erforderlichen Variablen, um Toolchains für die sofort einsatzfähige Funktionalität zu erstellen. Verwenden Sie anschließend die optionalen Variablen, um weitere Anpassungen an Ihren Toolchains vorzunehmen.
Erforderliche Eingabevariablen
| Name | Beschreibung | Typ | Standard |
|---|---|---|---|
toolchain_name |
Diese Variable gibt den Stammnamen für die Namen der CI-, CD- und CC-Toolchains an. Es wird automatisch ein festes Suffix angehängt. Die Einstellung DevSecOps erzeugt Werkzeugketten mit den Namen DevSecOps-CI-Toolchain,
DevSecOps-CD-Toolchain und DevSecOps-CC-Toolchain. Der vollständige Name jeder Toolchain kann unabhängig voneinander mit ci_toolchain_name, cd_toolchain_name und cc_toolchain_name festgelegt werden. |
string |
"DevSecOps" |
toolchain_region |
Die Kennung der Region, die standardmäßig für die Erstellung von Ressourcen und die Suche nach Dienstinstanzen verwendet wird. Dies kann für jede Ressource/jeden Dienst einzeln außer Kraft gesetzt werden. | string |
"us-south" |
toolchain_resource_group |
Die Ressourcengruppe, die standardmäßig für die Erstellung von Ressourcen und die Suche nach Dienstinstanzen verwendet wird. Dies kann für jede Ressource/jeden Dienst einzeln außer Kraft gesetzt werden. | string |
"Default" |
registry_namespace |
Ein eindeutiger Namespace innerhalb der IBM Cloud Container Registry-Region, in der das Anwendungsimage gespeichert ist. | string |
"" |
sm_location |
Die Region, in der sich die Instanz Secrets Manager befindet. Dies gilt für die Integration von CI, CD und CC Secret Manager. | string |
"us-south" |
sm_name |
Der Name einer vorhandenen Secret Managers-Instanz. Dies gilt für die Integration von CI, CD und CC Secret Manager. | string |
"sm-instance" |
sm_resource_group |
Der Name der bestehenden Ressourcengruppe, die die Instanz Secrets Manager für Ihre Geheimnisse enthält. Dies gilt für die Integration von CI, CD und CC Secret Manager. | string |
"Default" |
sm_secret_group |
Die geheime Gruppe Secrets Manager enthält die Geheimnisse für die Pipelines DevSecOps. Dies gilt für die Integration von CI, CD und CC Secret Manager. | string |
"Default" |
ci_pipeline_properties |
Dieses JSON stellt die Pipeline-Eigenschaften dar, die sowohl zu den CI- als auch zu den PR-Pipelines in der CI-Toolchain gehören. Jedes Element in der JSON-Datei stellt eine separate Pipeline-Eigenschaft dar. Drei Attribute sind erforderlich,
um eine Eigenschaft zu erstellen. Dabei handelt es sich um das Feld name (wie der Name in den Pipeline-Eigenschaften erscheint), das Feld type (Text, Secure und Enum) und dann das Feld value. Geben
Sie Geheimnisse nicht direkt in JSON für den Typ secure ein. Stattdessen sollte der Wert für einen Typ secret eine CRN zu einem Geheimnis im konfigurierten Geheimdienstanbieter oder ein Verweis auf ein Geheimnis
im konfigurierten Geheimdienstanbieter sein. |
string |
"" |
cd_pipeline_properties |
Dieses JSON stellt die Pipeline-Eigenschaften dar, die zu der CD-Pipeline in der CD-Toolchain gehören. Jedes Element in der JSON-Datei stellt eine separate Pipeline-Eigenschaft dar. Drei Attribute sind erforderlich, um eine Eigenschaft
zu erstellen. Dabei handelt es sich um das Feld name (wie der Name in den Pipeline-Eigenschaften erscheint), das Feld type (Text, Secure und Enum) und dann das Feld value. Geben Sie Geheimnisse
nicht direkt in JSON für den Typ secure ein. Stattdessen sollte der Wert für einen Typ secret eine CRN zu einem Geheimnis im konfigurierten Geheimdienstanbieter oder ein Verweis auf ein Geheimnis im konfigurierten
Geheimdienstanbieter sein. |
string |
"" |
cc_pipeline_properties |
Dieses JSON stellt die Pipeline-Eigenschaften dar, die zu der CC-Pipeline in der CC-Toolchain gehören. Jedes Element in der JSON-Datei stellt eine separate Pipeline-Eigenschaft dar. Drei Attribute sind erforderlich, um eine Eigenschaft
zu erstellen. Dabei handelt es sich um das Feld name (wie der Name in den Pipeline-Eigenschaften erscheint), das Feld type (Text, Secure und Enum) und dann das Feld value. Geben Sie Geheimnisse
nicht direkt in JSON für den Typ secure ein. Stattdessen sollte der Wert für einen Typ secret eine CRN zu einem Geheimnis im konfigurierten Geheimdienstanbieter oder ein Verweis auf ein Geheimnis im konfigurierten
Geheimdienstanbieter sein. |
string |
"" |
cluster_name |
(nur bei Variante Kubernetes erforderlich) Name des Clusters Kubernetes, in dem die Anwendung bereitgestellt wird. Dadurch wird derselbe Clustername für CI- und CD-Toolchains festgelegt. Siehe ci_cluster_name und cd_cluster_name,
um verschiedene Clusternamen festzulegen. Standardmäßig wird der Clusternamensraum für CI auf dev und für CD auf prod gesetzt. Diese können über ci_cluster_namespace und cd_cluster_namespace geändert werden. |
string |
"mycluster-free" |
ci_code_engine_project |
(nur in der Variante Kubernetes erforderlich) Der Name des zu verwendenden Code Engine Projekts. Das Projekt wird erstellt, wenn es noch nicht existiert. | string |
"DevSecOps_CE" |
cd_code_engine_project |
(nur in der Variante Kubernetes erforderlich) Der Name des Code Engine Projekts, das für den Promoted Code der CD-Pipeline verwendet werden soll. Das Projekt wird erstellt, wenn es noch nicht existiert. | string |
"Sample_CD_Project" |
ibmcloud_api_key |
API-Schlüssel, der die Toolchains erstellt. |
Die Variablen mit dem Präfix ci, cd und cc gelten für die CI-, CD-und CC-Toolchains. Variablen ohne Präfix gelten für alle Toolchains. Wenn Sie außerdem die Standardwerte für die Variableneingaben mit Präfix
ändern, haben die Variableneingaben mit Präfix Vorrang vor Variableneingaben ohne Präfix.
Optionale Eingabevariablen
| Name | Beschreibung | Typ | Standard |
|---|---|---|---|
add_code_engine_prefix |
Setzen Sie diese Option auf true, um prefix zu verwenden, um den Projektnamen der Code-Engine ein Präfix hinzuzufügen. |
bool |
true |
add_container_name_suffix |
Setzen Sie diesen Wert auf true, um ein zufälliges Suffix an den angegebenen ICR-Namen anzuhängen. |
bool |
false |
add_pipeline_definitions |
Setzen Sie diese Option auf true, um Rohrleitungsdefinitionen hinzuzufügen. |
string |
"true" |
app_group |
Geben Sie den Benutzer oder die Gruppe Git für das Anwendungs-Repository an. | string |
"" |
app_repo_auth_type |
Wählen Sie die Authentifizierungsmethode, die für den Zugriff auf das Repository Git verwendet wird. Gültige Werte sind "oauth" oder "pat". Der Standardwert ist oauth, wenn er nicht gesetzt ist. pat ist ein git personal access token. |
string |
"" |
app_repo_branch |
Dies ist der Repository-Zweig, der von der Standard-Beispielanwendung verwendet wird. Wenn app_repo_existing_url angegeben wird, muss der Zweig den Standardzweig für dieses Repository widerspiegeln. Typischerweise sind diese
Zweige main oder master. |
string |
"main" |
app_repo_clone_from_url |
Setzen Sie die Standard-Beispielanwendung außer Kraft, indem Sie Ihre eigene Beispielanwendung URL bereitstellen, die in das App-Repository geklont wird. Hinweis: Verwendet den Modus clone_if_not_exists, d. h. wenn das App-Repository
bereits existiert, bleibt der Inhalt des Repositorys unverändert. |
string |
"" |
app_repo_clone_to_git_id |
Setzen Sie diesen Wert auf github für github.com oder auf die GUID eines benutzerdefinierten GitHub Enterprise. |
string |
"" |
app_repo_clone_to_git_provider |
Standardmäßig wird dies auf "hostedgit" gesetzt, andernfalls auf "githubconsolidated" für GitHub Repositories. | string |
"" |
app_repo_existing_git_id |
Setzen Sie diesen Wert auf github für github.com oder auf die GUID eines benutzerdefinierten GitHub Enterprise. |
string |
"" |
app_repo_existing_git_provider |
Standardmäßig wird dies auf "hostedgit" gesetzt, andernfalls auf "githubconsolidated" für GitHub Repositories. | string |
"" |
app_repo_existing_url |
Bringen Sie Ihr eigenes, bestehendes Anwendungs-Repository mit, indem Sie die URL. Dadurch wird eine Integration für Ihr Anwendungs-Repository erstellt, anstatt das Standardbeispiel zu klonen. Für Repositories, die in einer anderen Organisation
existieren, muss ein Git Token verwendet werden. Siehe app_repo_git_token_secret_name unter optionale Variablen. |
string |
"__NOTSET__" |
app_repo_git_token_secret_crn |
Die CRN des Git-Tokens, das für den Zugriff auf das Repository der Beispielanwendung verwendet wird. | string |
"" |
app_repo_git_token_secret_name |
Name des Git Token-Geheimnisses im Secret Provider, das für den Zugriff auf das Repository der Beispielanwendung (oder bringen Sie Ihr eigenes mit) verwendet wird. | string |
"" |
app_repo_secret_group |
Geheime Gruppe für das Geheimnis des App-Repositorys. Standardmäßig wird der unter sm_secret_group eingestellte Wert verwendet, wenn er nicht gesetzt ist. Wird nur mit Secrets Manager verwendet. |
string |
"" |
authorization_policy_creation |
Deaktivieren Sie den Toolchain-Dienst auf Secrets Manager / Key Protect /Benachrichtigungsdienst Autorisierungsrichtlinie erstellen. Zum Inaktivieren setzen Sie den Wert auf disabled. Dies gilt für CI-, CD-und CC-Toolchains.
Zur unabhängigen Einstellung siehe ci_authorization_policy_creation, cd_authorization_policy_creation und cc_authorization_policy_creation. |
string |
"" |
autostart |
Setzen Sie diese Option auf true, um die CI-Pipeline in der CI-Toolchain nach der Erstellung automatisch auszuführen. |
bool |
false |
cluster_name |
Name des Kubernetes-Clusters, in dem die Anwendung implementiert ist. Dadurch wird derselbe Clustername für CI- und CD-Toolchains festgelegt. Siehe ci_cluster_name und cd_cluster_name, um verschiedene Clusternamen
festzulegen. Standardmäßig wird der Clusternamensraum für CI auf dev und für CD auf prod gesetzt. Diese können über ci_cluster_namespace und cd_cluster_namespace geändert werden. |
string |
"mycluster-free" |
code_engine_project |
Der Name des zu verwendenden Code Engine Projekts. Erstellt, wenn er nicht existiert. Gilt sowohl für die CI- als auch für die CD-Toolchain. Zur individuellen Einstellung verwenden Sie ci_code_engine_project und cd_code_engine_project. |
string |
"" |
compliance_pipeline_branch |
Die Verzweigung Compliance Pipeline Definitionen. Siehe ci_compliance_pipeline_branch, cd_compliance_pipeline_branch und cc_compliance_pipeline_branch für unabhängige Einstellungen. |
string |
"open-v10" |
compliance_pipeline_existing_repo_url |
Die URL eines bestehenden Repositoriums für Compliance-Pipelines. | string |
"" |
compliance_pipeline_group |
Geben Sie einen Benutzer oder eine Gruppe für das Compliance-Pipeline-Repository an. | string |
"" |
compliance_pipeline_repo_auth_type |
Wählen Sie die Authentifizierungsmethode, die für den Zugriff auf das Repository Git verwendet wird. Gültige Werte sind "oauth" oder "pat". Der Standardwert ist oauth, wenn er nicht gesetzt ist. pat ist ein git personal access token. |
string |
"" |
compliance_pipeline_repo_blind_connection |
Wenn Sie diesen Wert auf true setzen, ist der Server im öffentlichen Internet nicht ansprechbar. IBM Cloud ist nicht in der Lage, die von Ihnen angegebenen Verbindungsdetails zu überprüfen. Bestimmte Funktionen, die einen
API-Zugang zum Git-Server erfordern, werden deaktiviert. Die Auslieferungspipeline funktioniert nur mit einem privaten Worker, der Netzwerkzugriff auf den Git-Server hat. |
bool |
false |
compliance_pipeline_repo_git_id |
Setzen Sie diesen Wert auf github für github.com oder auf die ID eines benutzerdefinierten GitHub Enterprise. |
string |
"" |
compliance_pipeline_repo_git_provider |
Git anbieter für Pipeline-Repo | string |
"" |
compliance_pipeline_repo_git_token_secret_crn |
Die CRN des Git-Tokens, das für den Zugriff auf das Repository der Beispielanwendung verwendet wird. | string |
"" |
compliance_pipeline_repo_git_token_secret_name |
Name des Git Token-Geheimnisses im Geheimdienstanbieter, der für den Zugriff auf das Repository für Compliance-Pipelines verwendet wird. | string |
"" |
compliance_pipeline_repo_name |
Legt den Namen für das Repository für Compliance-Pipelines fest, wenn es geklont wird. Das erwartete Verhalten ist die Verknüpfung mit einem bestehenden Repository für die Einhaltung von Richtlinien. | string |
"" |
compliance_pipeline_repo_root_url |
(Optional) Die URL des Servers. z. B. https://git.example.com | string |
"" |
compliance_pipeline_repo_secret_group |
Geheime Gruppe für das Geheimnis des Compliance Pipeline Repository. Standardmäßig wird der unter sm_secret_group eingestellte Wert verwendet, wenn er nicht gesetzt ist. Wird nur mit Secrets Manager verwendet. |
string |
"" |
compliance_pipeline_repo_title |
(Optional) Der Titel des Servers, z. B. My Git Enterprise Server. | string |
"" |
compliance_pipeline_repo_use_group_settings |
Setzen Sie diese Option auf true, um Repository-Einstellungen auf Gruppenebene auf das Compliance-Pipeline-Repository anzuwenden. Siehe repo_git_provider als Beispiel. |
bool |
true |
continuous_delivery_service_name |
Der Name der CD-Instanz. | string |
"cd-devsecops" |
cos_api_key_secret_crn |
Die CRN des Cloud Object Storage apikey. Gilt für die CI-, CD- und CC-Toolchains. Kann unabhängig voneinander mit ci_cos_api_key_secret_crn,cd_cos_api_key_secret_crn,cc_cos_api_key_secret_crn besetzen. |
string |
"" |
cos_api_key_secret_group |
Geheime Gruppe für das COS api key secret. Standardmäßig wird der unter sm_secret_group eingestellte Wert verwendet, wenn er nicht gesetzt ist. Wird nur mit Secrets Manager verwendet. |
string |
"" |
cos_api_key_secret_name |
Name des Cloud Object Storage API-Schlüsselgeheimnisses im Geheimdienstanbieter für den Zugriff auf den COS-Eimer für Beweismittel. Außerdem müssen cos_endpoint und cos_bucket_name eingestellt werden. Diese Einstellung
legt denselben API-Schlüssel für die COS-Einstellungen in den CI-, CD- und CC-Toolchains fest. |
string |
"" |
cos_api_key_secret_value |
Ein vom Benutzer bereitgestellter API-Schlüssel mit COS-Zugriffsberechtigungen, der an Secrets Manager übertragen werden kann. Siehe cos_api_key_secret_name und create_cos_api_key. |
string |
"" |
cos_bucket_name |
Legen Sie den Namen Ihres COS-Buckets fest. Dadurch wird derselbe COS-Bucketname für die CI-, CD-und CC-Toolchains angewendet. Informationen zum separaten Festlegen finden Sie unter ci_cos_bucket_name, cd_cos_bucket_name und cc_cos_bucket_name. |
string |
"" |
cos_endpoint |
Der Endpunkt für die Cloud Object Stroage-Instanz, die den Evidence Bucket enthält. Diese Einstellung legt denselben Endpunkt für COS in den CI-, CD-und CC-Toolchains fest. Siehe ci_cos_endpoint, cd_cos_endpoint und cc_cos_endpoint, um die Endpunkte unabhängig voneinander einzustellen. |
string |
"" |
| cos_instance_crn | Die CRN der Instanz Cloud Object Storage, die den gewünschten Bucket enthält. Dieser Wert wird benötigt, um die richtigen Zugriffsrichtlinien zu generieren, wenn IAM-Dienstanmeldeinformationen erstellt werden. | string |
"" |
create_access_group |
Setzen Sie diese Option auf true, um eine Zugriffsgruppe für die Operationen der DevSecOps Toolchains zu erstellen. |
bool |
false |
create_cc_toolchain |
Boolesches Flag, das bestimmt, ob die DevSecOps CC Toolchain erstellt wird. | bool |
true |
create_cd_instance |
Stellen Sie true ein, um Continuous Delivery Service zu erstellen. |
bool |
false |
create_cd_toolchain |
Boolesches Flag, das bestimmt, ob die DevSecOps CD-Toolchain erstellt wird. | bool |
true |
create_ci_toolchain |
Kennzeichen, das bestimmt, ob die DevSecOps CI-Toolchain erstellt wird. Wenn diese Toolchain nicht erstellt wird, müssen Werte für die folgenden Variablen gesetzt werden: issues_repo_url und inventory_repo_url. | bool |
true |
create_code_engine_access_policy |
Fügen Sie dem generierten IAM-Zugangsschlüssel eine Code Engine-Zugangsrichtlinie hinzu. Informationen hierzu finden Sie unter create_ibmcloud_api_key. |
bool |
true |
create_cos_api_key |
Setzen Sie diese Option auf true, um eine cos-api-key zu erstellen und dem Secrets Provider hinzuzufügen. |
bool |
false |
create_git_token |
Setzen Sie diese Option auf true, um das angegebene persönliche Zugangs-Token-Geheimnis zu erstellen und dem Secrets Provider hinzuzufügen. Verwenden Sie repo_git_token_secret_value, um den Wert einzustellen. |
bool |
false |
create_git_triggers |
Setzen Sie diese Option auf true, um die Git zu erstellen, die mit den Compliance-Repos und der Beispielanwendung verbunden sind. |
string |
"true" |
create_ibmcloud_api_key |
Setzen Sie diese Option auf true, um eine ibmcloud-api-key zu erstellen und dem Secrets Provider hinzuzufügen. |
bool |
false |
create_icr_namespace |
Setzen Sie diese Option auf true, damit Terraform den Registry-Namespace erstellt. Die Einstellung false bewirkt, dass die CI-Pipeline den Namespace erstellt, wenn er noch nicht existiert. Hinweis: Wenn eine Terraform-Zerstörung
verwendet wird, wird der ICR-Namensraum zusammen mit allen Bildern entfernt. |
bool |
false |
create_kubernetes_access_policy |
Fügen Sie dem generierten IAM-Zugangsschlüssel eine Kubernetes-Zugangsrichtlinie hinzu. Informationen hierzu finden Sie unter create_ibmcloud_api_key. |
bool |
false |
create_privateworker_secret |
Setzen Sie diese Option auf true, um dem Secrets-Provider einen bestimmten privaten Api-Schlüssel für Arbeitsdienste hinzuzufügen. Dies ermöglicht auch eine Integration privater Arbeitsmittel in die Toolchains. |
bool |
false |
create_secret_group |
Setzen Sie den Wert auf true, um die angegebene geheime Gruppe Secrets Manager zu erstellen. |
bool |
false |
create_signing_key |
Stellen Sie true ein, um eine signing-key und die signing-certificate zum Secrets Provider hinzuzufügen. |
bool |
false |
create_triggers |
Setzen Sie diese Option auf true, um die mit den Compliance-Repos und der Beispielanwendung verbundenen Standardauslöser zu erstellen. |
string |
"true" |
enable_pipeline_notifications |
Wenn diese Option aktiviert ist, werden die Ereignisse des Pipeline-Laufs an die Event Notifications und Slack-Integrationen in der umschließenden Toolchain gesendet. | string |
"" |
enable_privateworker |
Setzen Sie diese Option auf true, um private Arbeitnehmer für die CI-, CD-, CC- und PR-Pipelines zu aktivieren. Im Secrets Manager muss ein gültiger Dienst-Api-Schlüssel eingestellt sein. Der Name dieses Geheimnisses kann
mit privateworker_credentials_secret_name angegeben werden. |
string |
"false" |
enable_secrets_manager |
Setzen Sie diese Option auf true, um die Secrets Manager Integrationen zu aktivieren. |
string |
"true" |
enable_slack |
Setzen Sie den Wert auf true, um die Slack-Toolchain-Integration zu erstellen. Dies erfordert eine gültige slack_channel_name, slack_team_name und eine gültige webhook (siehe slack_webhook_secret_name).
Diese Einstellung gilt für CI-, CD-und CC-Toolchains. |
string |
"false" |
environment_prefix |
Standardmäßig ibm:yp:. Dieser wird bei Bedarf automatisch als Präfix für die Regionen gesetzt. Zum Beispiel ibm:yp:us-south. |
string |
"ibm:yp:" |
environment_tag |
Der Tagname, der die Zielumgebung im Bestand darstellt. Beispiel: prod_latest. | string |
"prod_latest" |
event_notifications_crn |
Stellen Sie die Event Notifications CRN ein, um eine Integration der Ereignisbenachrichtigung zu erstellen. Dieser Parameter gilt für die CI-, CD- und CC-Toolchains. Kann unabhängig mit ci_event_notifications_crn, cd_event_notifications_crn,
cc_event_notifications_crn eingestellt werden. |
string |
"" |
event_notifications_tool_name |
Der Name der Event Notifications Integration. | string |
"Event Notifications" |
force_create_standard_api_key |
Setzen Sie diese Option auf true, um die Erstellung eines Standard-Api-Schlüssels zu erzwingen. Standardmäßig ist der generierte Apikey ein Dienst-Api-Schlüssel. Es wird empfohlen, ein Git Token zu verwenden, wenn Sie den
Dienst-Api-Schlüssel verwenden. Wenn der Benutzer zu einem Konto eingeladen wurde und nicht der Eigentümer des Kontos ist, werden bei der Erstellung der Toolchain die Standard-Compliance-Repositories im Konto des Benutzers erstellt,
und die Service-Api hat keinen Zugriff auf diese Repositories. In diesem Fall ist ein Git Token für die Repositories erforderlich. Siehe repo_git_token_secret_name für weitere Einzelheiten. Die Alternative ist, force_create_standard_api_key auf true zu setzen, um einen Standard-Api-Schlüssel zu erstellen. |
bool |
false |
ibmcloud_api |
Die Umwelt URL. Wenn diese Option nicht gesetzt ist, wird sie standardmäßig auf https://cloud.ibm.com |
string |
"" |
ibmcloud_api_key |
Der API-Schlüssel, der zur Erstellung der Toolchains verwendet wird. (Siehe Leitfaden für den Einsatz). | string |
nicht zutreffend |
inventory_group |
Geben Sie den Benutzer oder die Gruppe Git für das Inventar-Repository an. | string |
"" |
inventory_repo_auth_type |
Wählen Sie die Authentifizierungsmethode, die für den Zugriff auf das Repository Git verwendet wird. Gültige Werte sind "oauth" oder "pat". Der Standardwert ist oauth, wenn er nicht gesetzt ist. pat ist ein git personal access token. |
string |
"" |
inventory_repo_existing_git_id |
Setzen Sie diesen Wert auf github für github.com oder auf die GUID eines benutzerdefinierten GitHub Enterprise. |
string |
"" |
inventory_repo_existing_git_provider |
Git anbieter für das Inventar-Repositorium. Wenn nicht eingestellt, wird standardmäßig hostedgit verwendet. |
string |
"" |
inventory_repo_existing_url |
Legen Sie fest, dass ein vorhandenes Inventar-Repository verwendet werden soll. | string |
"" |
inventory_repo_git_token_secret_crn |
Die CRN des Git Tokens, das für den Zugriff auf das Inventory Repository verwendet wird. | string |
"" |
inventory_repo_git_token_secret_name |
Name des Git Token-Geheimnisses im Secret Provider, das für den Zugriff auf das Inventory Repository verwendet wird. | string |
"" |
inventory_repo_integration_owner |
Der Name des Eigentümers der Repository-Integration. | string |
"" |
inventory_repo_name |
Legen Sie fest, dass ein benutzerdefinierter Name für das Inventar-Repository verwendet werden soll. | string |
"" |
inventory_repo_secret_group |
Geheime Gruppe für das Geheimnis des Bestandsverzeichnisses. Standardmäßig wird der unter sm_secret_group eingestellte Wert verwendet, wenn er nicht gesetzt ist. Wird nur mit Secrets Manager verwendet. |
string |
"" |
issues_group |
Geben Sie den Git Benutzer oder die Gruppe für das Issues Repository an. | string |
"" |
issues_repo_auth_type |
Wählen Sie die Authentifizierungsmethode, die für den Zugriff auf das Repository Git verwendet wird. Gültige Werte sind "oauth" oder "pat". Der Standardwert ist oauth, wenn er nicht gesetzt ist. pat ist ein git personal access token. |
string |
"" |
issues_repo_existing_git_id |
Setzen Sie diesen Wert auf github für github.com oder auf die GUID eines benutzerdefinierten GitHub Enterprise. |
string |
"" |
issues_repo_existing_git_provider |
Git anbieter für das Issues Repo. Wenn nicht eingestellt, wird standardmäßig hostedgit verwendet. |
string |
"" |
issues_repo_existing_url |
Standardmäßig wird dies auf "hostedgit" gesetzt, andernfalls auf "githubconsolidated" für GitHub Repositories. | string |
"" |
issues_repo_git_token_secret_crn |
Die CRN des Git-Tokens, das für den Zugriff auf das Issues-Repository verwendet wird. | string |
"" |
issues_repo_git_token_secret_name |
Name des Git Token Secret im Secret Provider, der für den Zugriff auf das Issues Repository verwendet wird. | string |
"" |
issues_repo_integration_owner |
Der Name des Eigentümers der Repository-Integration. | string |
"" |
issues_repo_name |
Legt fest, dass ein benutzerdefinierter Name für das Issues-Repository verwendet wird. | string |
"" |
issues_repo_secret_group |
Geheime Gruppe für das Geheimnis des Issues Repository. Standardmäßig wird der unter sm_secret_group eingestellte Wert verwendet, wenn er nicht gesetzt ist. Wird nur mit Secrets Manager verwendet. |
string |
"" |
pipeline_config_group |
Geben Sie den Git Benutzer oder die Gruppe für das Compliance-Pipeline-Repository an. | string |
"" |
pipeline_config_repo_auth_type |
Wählen Sie die Authentifizierungsmethode, die für den Zugriff auf das Repository Git verwendet wird. Gültige Werte sind "oauth" oder "pat". Der Standardwert ist oauth, wenn er nicht gesetzt ist. pat ist ein git personal access token. |
string |
"" |
pipeline_config_repo_branch |
Geben Sie den Zweig an, der die benutzerdefinierte Datei pipeline-config.yaml enthält. | string |
"" |
pipeline_config_repo_clone_from_url |
Geben Sie ein Repository an, das eine benutzerdefinierte pipeline-config.yaml Datei enthält. | string |
"" |
pipeline_config_repo_existing_url |
Geben Sie ein vorhandenes Repository an, das eine benutzerdefinierte Datei pipeline-config.yaml enthält, und verlinken Sie es. | string |
"" |
pipeline_config_repo_git_id |
Setzen Sie diesen Wert auf github für github.com oder auf die GUID eines benutzerdefinierten GitHub Enterprise. |
string |
"" |
pipeline_config_repo_git_provider |
Git für Pipeline-Repository-Konfiguration | string |
"" |
pipeline_config_repo_git_token_secret_crn |
Die CRN des Tokens Git für den Zugriff auf das Repository für die Pipeline-Konfiguration. | string |
"" |
pipeline_config_repo_git_token_secret_name |
Name des Git Token Secret im Secret Provider, der für den Zugriff auf das Pipeline Config Repository verwendet wird. | string |
"" |
pipeline_config_repo_secret_group |
Geheime Gruppe für das Geheimnis des Pipeline-Konfigurations-Repository. Standardmäßig wird der unter sm_secret_group eingestellte Wert verwendet, wenn er nicht gesetzt ist. Wird nur mit Secrets Manager verwendet. |
string |
"" |
pipeline_git_tag |
Der GIT-Tag-Selektor für die Definitionen der Compliance Pipelines. | string |
"" |
pipeline_ibmcloud_api_key_secret_crn |
Die CRN des IBMCloud apikey, der für die Ausführung der Pipelines verwendet wird. | string |
"" |
pipeline_ibmcloud_api_key_secret_group |
Geheime Gruppe für den geheimen ibmcloud-API-Schlüssel der Pipeline. Standardmäßig wird der unter sm_secret_group eingestellte Wert verwendet, wenn er nicht gesetzt ist. Wird nur mit Secrets Manager verwendet. |
string |
"" |
pipeline_ibmcloud_api_key_secret_name |
Name des geheimen Cloud-API-Schlüssels im geheimen Anbieter für die Ausführung der Pipelines. Gilt für die CI-, CD- und CC-Toolchains. | string |
"ibmcloud-api-key" |
pipeline_ibmcloud_api_key_secret_value |
Ein vom Benutzer bereitgestellter Api-Schlüssel für die Ausführung der Toolchain-Pipelines, die auf Secrets Manager gepusht werden können. Siehe pipeline_ibmcloud_api_key_secret_name und create_ibmcloud_api_key. |
string |
"" |
pipeline_git_tag |
Der GIT-Tag-Selektor für die Definitionen der Compliance Pipelines. | string |
"" |
prefix |
Ein Präfix, das zu den Toolchain-Ressourcen hinzugefügt wird. | string |
"" |
privateworker_credentials_secret_crn |
Die CRN für den Privatangestellten ist geheim. | string |
"" |
privateworker_credentials_secret_group |
Präfix der geheimen Gruppe für das Geheimnis des privaten Arbeiters. Falls nicht festgelegt, wird standardmäßig sm_secret_group verwendet. Wird nur mit Secrets Manager verwendet. |
string |
"" |
privateworker_credentials_secret_name |
Name des Privatangestelltengeheimnisses im Geheimdienstanbieter. | string |
"" |
privateworker_name |
Der Name des privaten Arbeitswerkzeugs Integration. | string |
"private-worker-tool-01" |
privateworker_secret_value |
Der private Api-Schlüssel des Arbeitsdienstes, der dem Geheimnis privateworker_credentials_secret_name im secrets provider hinzugefügt wird. |
string |
"" |
registry_namespace |
Ein eindeutiger Namespace innerhalb der IBM Cloud Container Registry-Region, in der das Anwendungsimage gespeichert ist. | string |
"" |
repo_apply_settings_to_compliance_repos |
Setzen Sie diese Option auf true, um dieselben Einstellungen auf alle Standard-Compliance-Repositories anzuwenden. Setzen Sie den Wert auf false, um diese Einstellungen nur auf die Beispielanwendung, die Pipeline-Konfiguration
und die Deployment-Repositories anzuwenden. |
bool |
true |
repo_blind_connection |
Wenn Sie diesen Wert auf true setzen, ist der Server im öffentlichen Internet nicht ansprechbar. IBM Cloud ist nicht in der Lage, die von Ihnen angegebenen Verbindungsdetails zu überprüfen. Bestimmte Funktionen, die einen
API-Zugang zum Git-Server erfordern, werden deaktiviert. Die Auslieferungspipeline funktioniert nur mit einem privaten Worker, der Netzwerkzugriff auf den Git-Server hat. |
bool |
false |
repo_git_id |
Die Git für die Compliance-Repositories. | string |
"" |
repo_git_provider |
Der Typ des Git. | string |
"" |
repo_git_token_secret_crn |
Der CRN für das Git-Token des Repositorys. | string |
"" |
repo_git_token_secret_name |
Name des geheimen Schlüssels des Git-Tokens im Provider für geheime Schlüssel. Wenn Sie den Namen eines geheimen Schlüssels für das Git-Token angeben, wird der Authentifizierungstyp automatisch auf pat gesetzt. |
string |
"" |
repo_git_token_secret_value |
Das persönliche Zugangs-Token, das dem Geheimnis repo_git_token_secret_name im Secrets Provider hinzugefügt wird. |
string |
"" |
repo_group |
Geben Sie den Git Benutzer oder die Gruppe für Ihre Anwendung an. Dies muss festgelegt werden, wenn der Repository-Authentifizierungstyp pat (persönliches Zugriffstoken) ist. |
string |
"" |
repo_root_url |
(Optional) Die URL des Servers. z. B. https://git.example.com | string |
"" |
repo_secret_group |
Geheime Gruppe in Secrets Manager, die das Geheimnis für das Repository enthält. Diese Variable setzt die gleiche geheime Gruppe für alle Repositories. Kann für jede geheime Gruppe außer Kraft gesetzt werden. Gilt nur bei Verwendung von Secrets Manager. | string |
"" |
repo_title |
(Optional) Der Titel des Servers, z. B. My Git Enterprise Server. | string |
"" |
repositories_prefix |
Präfixname für das geklonte Konformitätsrepository. Für den Wert repositories_prefix sind nur a-z, A-Z und 0-9 sowie die Sonderzeichen -_ zulässig. Außerdem darf die Zeichenkette nicht mit einem Sonderzeichen enden oder zwei
aufeinanderfolgende Sonderzeichen enthalten. |
string |
"compliance" |
rotate_signing_key |
Setzen Sie diese Option auf true, um den Signierschlüssel und das Signierzertifikat zu drehen. Es ist wichtig, eine Sicherungskopie des aktuellen Code Signing-Zertifikats zu erstellen, da anstehende CD-Bereitstellungen möglicherweise
eine Image-Validierung mit dem vorherigen Signing-Schlüssel erfordern. |
bool |
false |
rotation_period |
Die Anzahl der Tage, bis die ibmcloud-api-key und die cos-api-key automatisch gedreht werden. |
number |
90 |
sample_default_application |
Der Name des Repositorys der Beispielanwendung. Die Repository-Quelle URL wird automatisch auf der Grundlage der Toolchain-Region berechnet. Der andere derzeit unterstützte Name ist code-engine-compliance-app. Alternativ kann
eine Integration erstellt werden, die mit einem bestehenden Repository verknüpft oder von diesem geklont werden kann. Siehe app_repo_existing_url und app_repo_clone_from_url, um das Standardverhalten der Beispielanwendung
außer Kraft zu setzen. |
string |
"code-engine-compliance-app" |
slack_channel_name |
Der Name des Slack-Kanals, in dem Benachrichtigungen gepostet werden. Dies gilt für CI-, CD-und CC-Toolchains. Zur unabhängigen Einstellung siehe ci_slack_channel_name, cd_slack_channel_name und cc_slack_channel_name. |
string |
"" |
slack_integration_name |
Der Name der Slack-Integration. | string |
"slack-compliance" |
slack_team_name |
Der Slack-Technologiename, d. h. das Wort oder der Satz vor .slack.com in der URL. Dies gilt für CI-, CD-und CC-Toolchains. Zur unabhängigen Einstellung siehe ci_slack_team_name, cd_slack_team_name und cc_slack_team_name. |
string |
"" |
slack_webhook_secret_crn |
Die CRN des Slack-Webhook-Geheimnisses, das für den Zugriff auf den angegebenen Slack-Kanal verwendet wird. | string |
"" |
slack_webhook_secret_group |
Geheime Gruppe für das Slack-Webhook-Geheimnis. Standardmäßig wird der unter sm_secret_group eingestellte Wert verwendet, wenn er nicht gesetzt ist. Wird nur mit Secrets Manager verwendet. |
string |
"" |
slack_webhook_secret_name |
Name des Webhook-Geheimnisses im Geheimdienstanbieter, das für den Zugriff auf den konfigurierten Slack-Kanal verwendet wird. Dies gilt für CI-, CD-und CC-Toolchains. Zur unabhängigen Einstellung siehe ci_slack_webhook_secret_name,
cd_slack_webhook_secret_name und cc_slack_webhook_secret_name. |
string |
"slack-webhook" |
sm_endpoint_type |
Die Arten von Dienstendpunkten, die für Secrets Manager anvisiert werden sollen. Gültige Werte sind private und public. |
string |
"private" |
sm_instance_crn |
Die CRN der Instanz Secrets Manager. Gilt für CI-, CD- und CC-Toolchains, sofern nicht individuell festgelegt. Die Einrichtung der Secrets Manager Integration über ein CRN hat Vorrang vor der Einrichtung ohne CRN. | string |
"" |
sm_integration_name |
Der Name der Secrets Manager Integration. | string |
"sm-compliance-secrets" |
sm_location |
Die Region, in der sich die Instanz Secrets Manager befindet. Dies gilt für die Integration von CI, CD und CC Secret Manager. | string |
"us-south" |
sm_name |
Der Name einer vorhandenen Secret Managers-Instanz. Dies gilt für die Integration von CI, CD und CC Secret Manager. | string |
"sm-instance" |
sm_resource_group |
Der Name der bestehenden Ressourcengruppe, die die Instanz Secrets Manager für Ihre Geheimnisse enthält. Dies gilt für die Integration von CI, CD und CC Secret Manager. | string |
"Default" |
sm_secret_expiration_period |
Die Anzahl der Tage, bis die Geheimnisse ablaufen. Leer lassen, um die erstellten Geheimnisse nicht ablaufen zu lassen. | string |
"" |
sm_secret_group |
Die geheime Gruppe Secrets Manager enthält die Geheimnisse für die Pipelines DevSecOps. Dies gilt für die Integration von CI, CD und CC Secret Manager. | string |
"Default" |
sonarqube_integration_name |
Der Name der SonarQube Integration. | string |
"SonarQube" |
sonarqube_is_blind_connection |
Wenn diese Option auf true gesetzt ist, wird IBM Cloud Continuous Delivery angewiesen, die Konfiguration dieser Integration nicht zu validieren. Setzen Sie diesen Wert auf true, wenn der Server SonarQube nicht
über das öffentliche Internet adressierbar ist. |
string |
"true" |
sonarqube_secret_crn |
Die CRN des für den Zugriff auf SonarQube verwendeten Geheimnisses. | string |
"" |
sonarqube_secret_group |
Geheime Gruppe für das SonarQube Geheimnis. Standardmäßig wird der unter sm_secret_group eingestellte Wert verwendet, wenn er nicht gesetzt ist. Wird nur mit Secrets Manager verwendet. |
string |
"" |
sonarqube_secret_name |
Der Name des Geheimnisses SonarQube im Geheimdienstanbieter. | string |
"sonarqube-secret" |
sonarqube_server_url |
Die URL zum SonarQube Server. | string |
"" |
sonarqube_user |
Der Name des Benutzers SonarQube. | string |
"" |
toolchain_access_group_name |
Der Name der Zugriffsgruppe DevSecOps. Informationen hierzu finden Sie unter create_access_group. |
string |
"devsecops-toolchain" |
toolchain_name |
Diese Variable gibt den Stammnamen für die Namen der CI-, CD- und CC-Toolchains an. Es wird automatisch ein festes Suffix angehängt. Die Einstellung DevSecOps erzeugt Werkzeugketten mit den Namen DevSecOps-CI-Toolchain,
DevSecOps-CD-Toolchain und DevSecOps-CC-Toolchain. Der vollständige Name jeder Toolchain kann unabhängig voneinander mit ci_toolchain_name, cd_toolchain_name und cc_toolchain_name festgelegt werden. |
string |
"DevSecOps" |
toolchain_region |
Die Kennung der Region, die standardmäßig für die Erstellung von Ressourcen und die Suche nach Dienstinstanzen verwendet wird. Dies kann für jede Ressource/jeden Dienst einzeln außer Kraft gesetzt werden. | string |
"us-south" |
toolchain_resource_group |
Die Ressourcengruppe, die standardmäßig für die Erstellung von Ressourcen und die Suche nach Dienstinstanzen verwendet wird. Dies kann für jede Ressource/jeden Dienst einzeln außer Kraft gesetzt werden. | string |
"Default" |
use_app_repo_for_cd_deploy |
Setzen Sie diese Option auf true, um das CI-Beispielanwendungs-Repository als Bereitstellungs-Repository in der CD-Pipeline zu verwenden. Dies wird in der Pipeline-Konfigurationsintegration festgelegt. |
bool |
true |
legacy_ref |
Setzen Sie den Wert auf true, um das alte Referenzformat für Secrets Manager-Geheimnisse zu verwenden. |
bool |
true |
Variablen für Toolchain-Erstellung
Die folgenden Variablen legen fest, welche Toolchains erstellt werden. Standardmäßig sind alle drei auf true eingestellt, was die DevSecOps CI-, CD- und CC-Toolchains erzeugt. Es kann eine beliebige Kombination der drei Toolchains
erstellt werden.
| Name | Beschreibung | Typ | Standard |
|---|---|---|---|
create_ci_toolchain |
Legt fest, ob die DevSecOps CI-Toolchain erstellt wird. Wenn diese Toolchain nicht erstellt wird, müssen Werte für die folgenden Variablen gesetzt werden: issues_repo_existing_url, und inventory_repo_existing_url. |
bool |
true |
create_cd_toolchain |
Boolesches Flag, das bestimmt, ob die DevSecOps CD-Toolchain erstellt wird. | bool |
true |
create_cc_toolchain |
Boolesches Flag, das bestimmt, ob die DevSecOps CC Toolchain erstellt wird. | bool |
true |
Konformitätsrepositorys
Wenn die CI-Toolchain nicht erstellt wird, müssen Sie die folgenden Variablen festlegen:
| Name | Beschreibung | Typ | Standard |
|---|---|---|---|
issues_repo_existing_url |
Ein Vorlagen-Repository zum Klonen von compliance-issues Vorlagen für die DevSecOps Toolchain. |
string |
"" |
inventory_repo_existing_url |
Ein Vorlagen-Repository zum Klonen des Compliance-Inventars für Referenzvorlagen der DevSecOps Toolchain. | string |
"" |
Eigenen Code integrieren
Standardmäßig wird für die DevSecOps Toolchains eine Beispielanwendung verwendet. Dieser Standardwert kann aktualisiert werden, um eine Integration für Ihr eigenes Anwendungsrepository zu erstellen, die so festgelegt werden kann, dass ein vorhandenes Repository geklont oder ein vorhandenes Repository verwendet wird. Legen Sie die folgenden Variablen fest, um ein vorhandenes Repository zu klonen oder zu verwenden:
| Name | Beschreibung | Typ | Standard |
|---|---|---|---|
app_repo_branch |
Dies ist der Repository-Zweig, der von der Standard-Beispielanwendung verwendet wird. Wenn app_repo_existing_url angegeben wird, muss der Zweig den Standardzweig für dieses Repository widerspiegeln. Typischerweise sind diese
Zweige main oder master. |
string |
"main" |
app_repo_clone_from_url |
Setzen Sie die Standard-Beispielanwendung außer Kraft, indem Sie Ihre eigene Beispielanwendung URL bereitstellen, die in das App-Repository geklont wird. Hinweis: Verwendet den Modus clone_if_not_exists, d. h. wenn das App-Repository
bereits existiert, bleibt der Inhalt des Repositorys unverändert. |
string |
"" |
app_repo_clone_to_git_id |
Setzen Sie diesen Wert auf github für github.com oder auf die GUID eines benutzerdefinierten GitHub Enterprise. |
string |
"" |
app_repo_clone_to_git_provider |
Standardmäßig wird dies auf "hostedgit" gesetzt, andernfalls auf "githubconsolidated" für GitHub Repositories. | string |
"" |
app_repo_existing_git_id |
Setzen Sie diesen Wert auf github für github.com oder auf die GUID eines benutzerdefinierten GitHub Enterprise. |
string |
"" |
app_repo_existing_git_provider |
Standardmäßig wird dies auf "hostedgit" gesetzt, andernfalls auf "githubconsolidated" für GitHub Repositories. | string |
"" |
app_repo_existing_url |
Bringen Sie Ihr eigenes, bestehendes Anwendungs-Repository mit, indem Sie die URL. Dadurch wird eine Integration für Ihr Anwendungs-Repository erstellt, anstatt das Standardbeispiel zu klonen. Für Repositories, die in einer anderen Organisation
existieren, muss ein Git Token verwendet werden. Siehe app_repo_git_token_secret_name unter optionale Variablen. |
string |
"__NOTSET__" |
Um eine vorhandene Anwendung auf einem selbst gehosteten GitHub Enterprise Server zu verwenden, verwenden Sie die folgenden Beispieleinstellungen:
| Name | Wert |
|---|---|
app_repo_existing_url |
"https://{github server}/{my-org}/{my-repo}.git" |
app_repo_branch |
"main" |
app_repo_existing_git_provider |
"githubconsolidated" |
app_repo_existing_git_id |
"integrated" |
Geheime Schlüssel
Zum Ausführen aller Toolchains benötigen Sie mindestens die folgenden geheimen Schlüssel:
- Ein API-Schlüssel zum Ausführen der Toolchains.
- Ein GPG-Schlüssel zum Signieren von Images in der CI-Toolchain.
Standardmäßig erwarten die DevSecOps Toolchains, dass die Geheimnisse im Secrets Manager liegen. Der API-Schlüssel muss mit einem ibmcloud-api-key-Eintrag und dem unter signing_key gespeicherten Signierschlüssel gespeichert
werden.
Um einen API-Schlüssel für die DevSecOps-Toolchains zu erstellen, siehe IBM Cloud® API-Schlüssel und überprüfen Sie die IAM-Zugangsberechtigungen.
Die IAM-Zugriffsberechtigungen sind nur relevant, wenn Sie Toolchains in einem anderen Konto ausführen. Verwechseln Sie den API-Schlüssel für die Ausführung der Toolchains nicht mit dem API-Schlüssel ibmcloud_api_key, der eine
der erforderlichen Eingaben für die Einrichtung der Toolchains ist.
ibmcloud-api-key und signing_key sind die Standardnamen der erwarteten geheimen Schlüssel in der Vault für geheime Schlüssel. Diese Standardnamen können geändert werden. Weitere Einzelheiten sind der folgenden Tabelle
zu entnehmen:
| Name | Beschreibung | Wert |
|---|---|---|
pipeline_ibmcloud_api_key_secret_name |
Name des geheimen Cloud-API-Schlüssels im geheimen Anbieter für die Ausführung der Pipelines. Gilt für die CI-, CD- und CC-Toolchains. | string |
ci_signing_key_secret_name |
Name des geheimen Schlüssels für Signierschlüssel im Provider für geheime Schlüssel. | "signing_key" |
Für weitere Namen geheimer Schlüssel suchen Sie in der Variablenliste nach "secret_name".
Optionale CI-, CD-und CC-Variablen
Wenn Sie mit der Code-Engine bereitstellen, siehe Optionale Code Engine CI- und CD-Variablen
| Name | Beschreibung | Typ | Standard |
|---|---|---|---|
deployment_repo_url |
Das Repository zum Klonen der Bereitstellung für die DevSecOps Toolchain-Vorlage. | string |
"" |
ibmcloud_api |
API-Endpunkt für IBM Cloud® | string |
"https://cloud.ibm.com" |
| Name | Beschreibung | Typ | Standard |
|---|---|---|---|
ci_app_name |
Name des Anwendungsimage und des Bestandseintrags. | string |
"hello-compliance-app" |
ci_app_repo_branch |
Dies ist der Repository-Zweig, der von der Standard-Beispielanwendung verwendet wird. Wenn app_repo_existing_url angegeben wird, muss der Zweig den Standardzweig für dieses Repository widerspiegeln. Typischerweise sind diese
Zweige main oder master. |
string |
"" |
ci_cluster_name |
Name des Clusters, in dem die Anwendung bereitgestellt wird. (kann derselbe Cluster sein, der für prod | string |
"" |
ci_cluster_namespace |
Name des Clusternamensraums, in dem die Anwendung bereitgestellt wird. | string |
"dev" |
ci_cluster_region |
Region, die den Cluster hostet, in dem die Anwendung bereitgestellt wird. Verwenden Sie die Kurzform der Regionen. Zum Beispiel us-south. |
string |
"" |
ci_cluster_resource_group |
Die Clusterressourcengruppe. | string |
"" |
ci_code_engine_project |
Der Name des zu verwendenden Code Engine Projekts. | string |
"DevSecOps_CE" |
ci_code_engine_region |
Die Region, die für das Projekt Code Engine erstellt bzw. gesucht werden soll | string |
"" |
ci_code_engine_resource_group |
Die Ressourcengruppe des Projekts Code Engine. | string |
"" |
ci_compliance_pipeline_pr_branch |
Die Verzweigung "Pipeline-Compliance-Pipeline für Bedarfsanforderungen". | string |
"" |
ci_pipeline_config_repo_branch |
Geben Sie den Zweig an, der die benutzerdefinierte Datei pipeline-config.yaml enthält. | string |
"" |
ci_pipeline_properties |
Dieses JSON stellt die Pipeline-Eigenschaften dar, die sowohl zu den CI- als auch zu den PR-Pipelines in der CI-Toolchain gehören. Jedes Element in der JSON-Datei stellt eine separate Pipeline-Eigenschaft dar. Drei Attribute sind erforderlich,
um eine Eigenschaft zu erstellen. Dabei handelt es sich um das Feld name (wie der Name in den Pipeline-Eigenschaften erscheint), das Feld type (Text, Secure und Enum) und dann das Feld value. Geben
Sie Geheimnisse nicht direkt in JSON für den Typ secure ein. Stattdessen sollte der Wert für einen Typ secret eine CRN zu einem Geheimnis im konfigurierten Geheimdienstanbieter oder ein Verweis auf ein Geheimnis
im konfigurierten Geheimdienstanbieter sein. |
string |
"" |
ci_pipeline_properties_filepath |
Der Pfad zu der Datei, die die Eigenschaft JSON enthält. Wenn dies nicht festgelegt ist und ci_pipeline_properties nicht festgelegt ist, wird standardmäßig die Datei properties.json im Stammverzeichnis des CI-Moduls
gelesen. |
string |
"" |
ci_privateworker_credentials_secret_crn |
Die CRN des privaten Arbeitsdienstes apikey, der die Pipeline-Aufgaben ausführt. | string |
"" |
ci_registry_region |
Die IBM Cloud Region, in der der IBM Cloud Container Registry Namespace erstellt werden soll. Verwenden Sie die Kurzform der Regionen. Zum Beispiel us-south. |
string |
"" |
ci_repository_properties |
Stringifiziertes JSON mit den Repositories und Triggern, die in den CI-Toolchain-Pipelines erstellt werden. | string |
"" |
ci_signing_key_secret_name |
Name des geheimen Signierschlüssels im Geheimdienstanbieter, der zum Signieren von Bildern/Artefakten verwendet wird. | string |
"signing-key" |
ci_toolchain_description |
Beschreibung für die CI-Toolchain. | string |
"Toolchain created with terraform template for DevSecOps CI Best Practices." |
ci_toolchain_name |
Der Name der CI-Toolchain. | string |
"" |
ci_trigger_git_enable |
Legen Sie true fest, um den Git-Auslöser für die CI-Pipeline zu aktivieren. |
bool |
true |
ci_trigger_manual_enable |
Legen Sie true fest, um den manuellen Auslöser für die CI-Pipeline zu aktivieren. |
bool |
true |
ci_trigger_pr_git_enable |
Setzen Sie diese Eigenschaft auf true, um den Auslöser Git der PR-Pipeline zu aktivieren. |
bool |
true |
ci_trigger_timed_cron_schedule |
Nur für Zeitgeberauslöser erforderlich. Cron-Ausdruck, der angibt, wann dieser Auslöser aktiviert wird. Die maximale Häufigkeit beträgt alle 5 Minuten. Die Zeichenfolge basiert auf der UNIX-crontab-Syntax: minute, hour, day of month, month, day of week. Beispiel: 0 * _/2 * * *-alle 2 Stunden. | string |
"0 4 * * *" |
ci_trigger_timed_enable |
Setzen Sie diese Eigenschaft auf true, um den zeitgesteuerte Auslöser der CI-Pipeline zu aktivieren. |
bool |
false |
| Name | Beschreibung | Typ | Standard |
|---|---|---|---|
cd_change_management_group |
Gruppe für Änderungsmanagement-Repository angeben | string |
"" |
cd_change_management_repo_auth_type |
Wählen Sie die Authentifizierungsmethode, die für den Zugriff auf das Repository Git verwendet wird. Gültige Werte sind "oauth" oder "pat". Der Standardwert ist oauth, wenn er nicht gesetzt ist. pat ist ein git personal access token. |
string |
"" |
cd_change_management_repo_git_token_secret_crn |
Der CRN für das Git-Token des Change-Management-Repositorys | string |
"" |
cd_change_management_repo_git_token_secret_name |
Name des geheimen Schlüssels des Git-Tokens im Provider für geheime Schlüssel. | string |
"" |
cd_change_management_repo_secret_group |
Geheime Gruppe für das Change Management Repository Secret. Standardmäßig wird der unter sm_secret_group eingestellte Wert verwendet, wenn er nicht gesetzt ist. Wird nur mit Secrets Manager verwendet. |
string |
"" |
cd_change_repo_clone_from_url |
Überschreiben Sie das Standard-Management-Repository, das in das Anwendungs-Repository geklont wird. Beachten Sie, dass der Modus clone_if_not_exists verwendet wird, d.h. wenn das Anwendungs-Repository bereits existiert, bleibt der Inhalt des Repositorys unverändert. | string |
"" |
cd_cluster_name |
Name des Clusters, in dem die Anwendung bereitgestellt wird. | string |
"" |
cd_cluster_namespace |
Name des Clusternamensraums, in dem die Anwendung bereitgestellt wird. | string |
"prod" |
cd_cluster_region |
Region, die den Cluster hostet, in dem die Anwendung bereitgestellt wird. Verwenden Sie die Kurzform der Regionen. Zum Beispiel us-south. |
string |
"" |
cd_code_engine_project |
Der Name des Code Engine-Projekts, das für den hochgestuften Code der CD-Pipeline verwendet wird Das Projekt wird erstellt, wenn es noch nicht existiert. | string |
"Sample_CD_Project" |
cd_code_engine_region |
Die Region, die für das Projekt Code Engine erstellt bzw. gesucht werden soll | string |
"" |
cd_code_engine_resource_group |
Die Ressourcengruppe des Projekts Code Engine. | string |
"" |
cd_code_signing_cert_secret_name |
Dies ist der Name des Geheimnisses im Secrets Provider für die Speicherung des Code Signing-Zertifikats. | string |
"signing-certificate" |
cd_deployment_group |
Geben Sie die Gruppe für die Implementierung an. | string |
"" |
cd_deployment_repo_auth_type |
Wählen Sie die Authentifizierungsmethode, die für den Zugriff auf das Repository Git verwendet wird. Gültige Werte sind "oauth" oder "pat". Der Standardwert ist oauth, wenn er nicht gesetzt ist. pat ist ein git personal access token. |
string |
"" |
cd_deployment_repo_clone_from_branch |
Wird verwendet, wenn deployment_repo_clone_from_url angegeben ist, der Standardzweig, der vom CD-Build verwendet wird, normalerweise entweder main oder master. | string |
"" |
cd_deployment_repo_clone_from_url |
Setzen Sie die Standard-Beispielanwendung außer Kraft, indem Sie Ihre eigene Beispielanwendung URL bereitstellen, die in das Anwendungs-Repository geklont wird. Beachten Sie, dass der Modus clone_if_not_exists verwendet wird, d.h. wenn das App-Repository bereits existiert, bleibt der Inhalt des Repositorys unverändert. | string |
"" |
cd_deployment_repo_clone_to_git_id |
Standardmäßig nicht vorhanden, sonst benutzerdefinierte Server-GUID oder andere Optionen für das Feld "git_id" in der Browser-Benutzeroberfläche. | string |
"" |
cd_deployment_repo_clone_to_git_provider |
Standardmäßig "hostedgit", ansonsten "githubconsolidated" oder "gitlab" verwenden. | string |
"" |
cd_deployment_repo_existing_branch |
Wird verwendet, wenn deployment_repo_existing_url angegeben wird, der Standardzweig, der beim CD-Build verwendet wird, normalerweise entweder main oder master. | string |
"" |
cd_deployment_repo_existing_git_id |
Setzen Sie diesen Wert auf github für github.com oder auf die GUID eines benutzerdefinierten GitHub Enterprise. |
string |
"" |
cd_deployment_repo_existing_git_provider |
Git anbieter für das Deployment Repo. Wenn nicht eingestellt, wird standardmäßig hostedgit verwendet. |
string |
"" |
cd_deployment_repo_existing_url |
Überschreiben, um Ihre eigene vorhandene URL für die Bereitstellung mitzubringen, die direkt verwendet wird, anstatt das Standardbereitstellungsmuster zu klonen. | string |
"" |
cd_deployment_repo_git_token_secret_crn |
Der CRN für das Git-Token des Bereitstellungsrepositorys | string |
"" |
cd_deployment_repo_git_token_secret_name |
Name des geheimen Schlüssels des Git-Tokens im Provider für geheime Schlüssel. | string |
"" |
cd_deployment_repo_secret_group |
Geheime Gruppe für das Geheimnis des Deployment-Repository. Standardmäßig wird der unter sm_secret_group eingestellte Wert verwendet, wenn er nicht gesetzt ist. Wird nur mit Secrets Manager verwendet. |
string |
"" |
cd_pipeline_config_repo_branch |
Geben Sie den Zweig an, der die benutzerdefinierte Datei pipeline-config.yaml enthält. | string |
"main" |
cd_pipeline_properties |
Dieses JSON stellt die Pipeline-Eigenschaften dar, die zu der CD-Pipeline in der CD-Toolchain gehören. Jedes Element in der JSON-Datei stellt eine separate Pipeline-Eigenschaft dar. Drei Attribute sind erforderlich, um eine Eigenschaft
zu erstellen. Dabei handelt es sich um das Feld name (wie der Name in den Pipeline-Eigenschaften erscheint), das Feld type (Text, Secure und Enum) und dann das Feld value. Geben Sie Geheimnisse
nicht direkt in JSON für den Typ secure ein. Stattdessen sollte der Wert für einen Typ secret eine CRN zu einem Geheimnis im konfigurierten Geheimdienstanbieter oder ein Verweis auf ein Geheimnis im konfigurierten
Geheimdienstanbieter sein. |
string |
"" |
cd_pipeline_properties_filepath |
Der Pfad zu der Datei, die die Eigenschaft JSON enthält. Wenn dies nicht festgelegt ist und cd_pipeline_properties nicht festgelegt ist, wird standardmäßig die Datei properties.json im Stammverzeichnis des CD-Moduls
gelesen. |
string |
"" |
cd_privateworker_credentials_secret_crn |
Die CRN des privaten Arbeitsdienstes apikey, der die Pipeline-Aufgaben ausführt. | string |
"" |
cd_region |
IBM Cloud region, die als Präfix für die Verzweigung des Bestandsverzeichnisses prod_latest verwendet wird. |
string |
"" |
cd_repository_properties |
Stringifiziertes JSON mit den Repositories und Triggern, die in den CI-Toolchain-Pipelines erstellt werden. | string |
"" |
cd_service_plan |
Der Dienstplan Continuous Delivery. Kann lite oder professional sein. |
string |
"professional" |
cd_toolchain_description |
Beschreibung der CD-Toolchain. | string |
"Toolchain created with terraform template for DevSecOps CD Best Practices." |
cd_toolchain_name |
Der Name der CD-Toolchain. | string |
"" |
cd_trigger_git_enable |
Legen Sie true fest, um den Git-Auslöser für die CD-Pipeline zu aktivieren. |
bool |
false |
cd_trigger_git_promotion_validation_branch |
Zweig für Git promotion validation listener. | string |
"prod" |
cd_trigger_git_promotion_validation_enable |
Aktivieren Sie Git promotion validation für Git promotion listener. | bool |
false |
cd_trigger_git_promotion_validation_listener |
Wählen Sie einen Tekton EventListener, der verwendet werden soll, wenn Git promotion validation listener trigger ausgelöst wird. | string |
"promotion-validation-listener-gitlab" |
cd_trigger_manual_enable |
Setzen Sie diese Eigenschaft auf true, um den manuellen Trigger der CD-Pipeline zu aktivieren. |
bool |
true |
cd_trigger_manual_promotion_enable |
Setzen Sie diese Eigenschaft auf true, um den Auslöser für manuelle Hochstufung der CD-Pipeline zu aktivieren. |
bool |
true |
cd_trigger_timed_cron_schedule |
Nur für Zeitgeberauslöser erforderlich. Cron-Ausdruck, der angibt, wann dieser Auslöser aktiviert wird. Die maximale Häufigkeit beträgt alle 5 Minuten. Die Zeichenfolge basiert auf der UNIX-crontab-Syntax: minute, hour, day of month, month, day of week. Beispiel: 0 * _/2 * * *-alle 2 Stunden. | string |
"0 4 * * *" |
cd_trigger_timed_enable |
Setzen Sie diese Option auf true, um den zeitgesteuerten Trigger der CD-Pipeline zu aktivieren. |
bool |
false |
change_management_existing_url |
Die URL für ein bestehendes Change Management Repository. | string |
"" |
change_management_repo_git_id |
Setzen Sie diesen Wert auf github für github.com oder auf die ID eines benutzerdefinierten GitHub Enterprise. |
string |
"" |
| Name | Beschreibung | Typ | Standard |
|---|---|---|---|
cc_app_repo_branch |
Der Standardzweig des App-Repositorys. | string |
"" |
cc_pipeline_config_repo_branch |
Geben Sie den Zweig an, der die benutzerdefinierte Datei pipeline-config.yaml enthält. | string |
"" |
cc_pipeline_properties |
Dieses JSON stellt die Pipeline-Eigenschaften dar, die zu der CC-Pipeline in der CC-Toolchain gehören. Jedes Element in der JSON-Datei stellt eine separate Pipeline-Eigenschaft dar. Drei Attribute sind erforderlich, um eine Eigenschaft
zu erstellen. Dabei handelt es sich um das Feld name (wie der Name in den Pipeline-Eigenschaften erscheint), das Feld type (Text, Secure und Enum) und dann das Feld value. Geben Sie Geheimnisse
nicht direkt in JSON für den Typ secure ein. Stattdessen sollte der Wert für einen Typ secret eine CRN zu einem Geheimnis im konfigurierten Geheimdienstanbieter oder ein Verweis auf ein Geheimnis im konfigurierten
Geheimdienstanbieter sein. |
string |
"" |
cc_pipeline_properties_filepath |
Der Pfad zu der Datei, die die Eigenschaft JSON enthält. Wenn dies nicht eingestellt ist und cc_pipeline_properties nicht eingestellt ist, wird standardmäßig die Datei properties.json im Stammverzeichnis des CC-Moduls
gelesen. |
string |
"" |
cc_repository_properties |
Stringifiziertes JSON mit den Repositories und Triggern, die in den CI-Toolchain-Pipelines erstellt werden. | string |
"" |
cc_toolchain_description |
Beschreibung für die CC Toolchain. | string |
"Toolchain created with terraform template for DevSecOps CC Best Practices." |
cc_toolchain_name |
Der Name der CC Toolchain. | string |
"" |
cc_trigger_manual_enable |
Setzen Sie diese Option auf true, um den manuellen Trigger der CC-Pipeline zu aktivieren. |
bool |
true |
cc_trigger_timed_cron_schedule |
Nur für Zeitgeberauslöser erforderlich. Cron-Ausdruck, der angibt, wann dieser Auslöser aktiviert wird. Die maximale Häufigkeit beträgt alle 5 Minuten. Die Zeichenfolge basiert auf der UNIX-crontab-Syntax: minute, hour, day of month, month, day of week. Beispiel: 0 * _/2 * * *-alle 2 Stunden. | string |
"0 4 * * *" |
cc_trigger_timed_enable |
Setzen Sie diese Eigenschaft auf true, um den zeitgesteuerte Auslöser der CI-Pipeline zu aktivieren. |
bool |
false |
Ausgabevariablen
| Name | Beschreibung |
|---|---|
app_repo_url |
Die URL für das App-Repository. |
compliance_cc_toolchain_id |
Die ID der Compliance-CC-Toolchain. |
compliance_cd_toolchain_id |
Die ID der Compliance-CD-Toolchain. |
compliance_ci_toolchain_id |
Die ID der Toolchain für Compliance-CIs. |
compliance_cc_toolchain_url |
Die URL der Compliance CC Toolchain. |
compliance_cd_toolchain_url |
Die URL der Compliance CD Toolchain. |
compliance_ci_toolchain_url |
Die URL der Compliance CI Toolchain. |
inventory_repo_url |
Die URL für das Bestandsrepository. |
issues_repo_url |
Die Ausgaben Repo URL. |
secrets_manager_instance_id |
Die ID der Instanz für die Verwaltung geheimer Schlüssel |