Projekt erstellen

In einem ProjektEine Sammlung von Artefakten, die Ressourcen und Infrastruktur als Codebereitstellungen definieren und verwalten. können Sie einsatzfähige Architekturen aus dem Katalog hinzufügen und ihre Konfiguration bearbeiten. Bei der Bereitstellung einer Konfiguration aus einem Projekt werden die Ressourcen auf der Grundlage der bereitgestellten Konfiguration gruppiert.

Vorbereitende Schritte

Die Ressourcen werden im Projektkonto des Benutzers erstellt. Sie müssen die Berechtigung haben, ein Projekt zu erstellen und die Berechtigung, die Projektressourcen innerhalb des Kontos zu erstellen. Vergewissern Sie sich, dass Sie den folgenden Zugang haben:

  • Die Rolle 'Bearbeiter' für den IBM Cloud-Projektservice.
  • Die Rolle 'Bearbeiter' und 'Manager' für den IBM Cloud® Schematics-Service
  • Die Betrachterrolle in der Ressourcengruppe für das Projekt

Weitere Informationen zu Zugriff und Berechtigungen finden Sie unter Benutzern den Zugriff auf Projekte zuweisen.

Hinzufügen von Benutzern zu einem Projekt

Der Projektzugang wird über IBM Cloud Identity and Access Management (IAM) gesteuert. Sie fügen einem Projekt Benutzer hinzu, indem Sie der Projektinstanz die Rolle Leser oder höher zuweisen. Weitere Informationen zur Zuweisung des Zugriffs auf Projekte finden Sie unter Zuweisung des Zugriffs von Benutzern auf Projekte.

Erstellen eines Projekts mit Hilfe der Konsole

Sie können ein Projekt erstellen, indem Sie auf das Navigationsmenüsymbol Navigationsmenüsymbol gehen und Projekte oder eine einsatzfähige Architektur im Katalog auswählen. Projekte können auch mit Hilfe der Projekt-API erstellt werden.

Hinzufügen einer einsatzfähigen Architektur zu einem Projekt über die Konsole

Bereitstellbare Architekturen, die Sie einem Projekt hinzufügen, werden als Konfigurationen in der Projekt-Benutzeroberfläche dargestellt. Nachdem Sie eine bereitstellbare Architektur zu einem Projekt hinzugefügt haben, können Sie Ihre Konfiguration bearbeiten, bevor Sie sie bereitstellen. Es gibt mehrere Möglichkeiten, eine einsatzfähige Architektur zu Ihrem Projekt hinzuzufügen.

Führen Sie die folgenden Schritte aus, um Ihrem Projekt über das Projekt-Dashboard eine verteilbare Architektur hinzuzufügen:

  1. Wählen Sie auf dem Projekt-Dashboard die Registerkarte Konfigurationen.
  2. Klicken Sie auf Erstellen.
  3. Wählen Sie eine einsatzfähige Architektur aus dem Katalog aus.
  4. Klicken Sie auf Konfigurieren und Bereitstellen.

Sie können eine verteilbare Architektur auch direkt aus dem Katalog zu einem Projekt hinzufügen:

  1. Rufen Sie IBM Cloud -Katalogauf.
  2. Wählen Sie die einsatzfähige Architektur aus.
  3. In der Katalogliste können Sie ein neues Projekt erstellen oder zu einem bestehenden Projekt hinzufügen.
  4. Klicken Sie auf Konfigurieren und Bereitstellen.

Anpassen einer einsatzfähigen Architektur in Ihrem Projekt

Abhängig von der verteilbaren Architektur können Sie sie möglicherweise anpassen, wenn Sie sie aus einem Katalog zu einem Projekt hinzufügen. Sie haben die folgenden Möglichkeiten:

  • Fügen Sie optional einsetzbare Architekturen hinzu, um die Lösung für einen bestimmten Anwendungsfall zu erweitern.
  • Tauschen Sie eine Architektur gegen eine andere aus. Wenn z. B. mehrere Datenbankoptionen angeboten werden, können Sie die gewünschte auswählen.
  • Wählen Sie eine bestehende Konfiguration einer Architektur in Ihrem Projekt aus, die Sie mit der hinzuzufügenden Architektur wiederverwenden möchten. Auf diese Weise können Sie die Kosten senken und dieselbe Bereitstellung für mehrere Architekturen wiederverwenden.

Klicken Sie im Abschnitt Diese Architektur erweitern der Katalogliste auf Anpassen, um Ihre Architektur zu verfeinern, bevor Sie sie konfigurieren und bereitstellen. Wenn Anpassen in der Katalogliste für die einsatzfähige Architektur nicht verfügbar ist, können Sie die Architektur dennoch konfigurieren und anpassen, indem Sie andere einsatzfähige Architekturen mit ihr in Ihrem Projekt stapeln.

Nachdem Sie Ihre Auswahl getroffen und die verteilbare Architektur zu Ihrem Projekt hinzugefügt haben, können Sie sie weiter anpassen, indem Sie auf der Registerkarte Konfigurationen das Symbol Optionen Optionen > Architektur anpassen wählen. Von dort aus können Sie weitere kompatible, einsatzfähige Architekturen hinzufügen, um die Lösung weiter anzupassen.

Um die Projektinformationen außerhalb des Dienstes IBM Cloud Projects zu sichern, können Sie das Projekt exportieren. Weitere Informationen finden Sie unter Projekt JSON.

Sehen Sie sich die Schritte zur Konfiguration und Bereitstellung einer verteilbaren Architektur an, wenn Sie bereit sind, Ressourcen aus einer verteilbaren Architektur in einem Projekt bereitzustellen.

Erstellen eines Projekts mit Hilfe der CLI

Um ein Projekt mit Hilfe der CLI zu erstellen, führen Sie den folgenden Befehl aus: ibmcloud project create:

ibmcloud project create [--definition DEFINITION | --definition-name DEFINITION-NAME --definition-destroy-on-delete=DEFINITION-DESTROY-ON-DELETE --definition-description DEFINITION-DESCRIPTION --definition-auto-deploy=DEFINITION-AUTO-DEPLOY --definition-monitoring-enabled=DEFINITION-MONITORING-ENABLED] --location LOCATION --resource-group RESOURCE-GROUP [--configs CONFIGS] [--environments ENVIRONMENTS]

Siehe ibmcloud project create finden Sie einen Beispielbefehl und weitere Informationen über die Befehlsparameter.

Hinzufügen einer einsatzfähigen Architektur zu einem Projekt mit Hilfe der CLI

Führen Sie den folgenden Befehl ibmcloud project config-create aus, um Ihrem Projekt mithilfe der Befehlszeilenschnittstelle eine verteilbare Architektur hinzuzufügen:

ibmcloud project config-create --project-id PROJECT-ID [--definition DEFINITION | --definition-compliance-profile DEFINITION-COMPLIANCE-PROFILE --definition-locator-id DEFINITION-LOCATOR-ID --definition-description DEFINITION-DESCRIPTION --definition-name DEFINITION-NAME --definition-environment-id DEFINITION-ENVIRONMENT-ID --definition-authorizations DEFINITION-AUTHORIZATIONS --definition-inputs DEFINITION-INPUTS --definition-settings DEFINITION-SETTINGS --definition-members DEFINITION-MEMBERS --definition-resource-crns DEFINITION-RESOURCE-CRNS] [--schematics SCHEMATICS | --schematics-workspace-crn SCHEMATICS-WORKSPACE-CRN]

Siehe ibmcloud project config-create finden Sie einen Beispielbefehl und weitere Informationen über die Befehlsparameter.

Um die Projektinformationen außerhalb des Dienstes IBM Cloud Projects zu sichern, können Sie das Projekt exportieren. Weitere Informationen finden Sie unter Projekt JSON.

Erstellen eines Projekts mit Hilfe der API

Sie können ein Projekt programmatisch erstellen, indem Sie die Projekt-API aufrufen, wie in der folgenden Beispielanforderung gezeigt:

curl -X POST --location --header "Authorization: Bearer {iam_token}" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{ "definition": { "name": "acme-microservice", "description": "A microservice to deploy on top of ACME infrastructure.", "authorizations": { "method": "trusted_profile", "trusted_profile_id": "Profile-9ac10c5c-195c-41ef-b465-68a6b6dg5f12" } }, "configs": [ { "definition": { "name": "account-stage", "description": "The stage account configuration.", "locator_id": "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global" } }, { "definition": { "name": "env-stage", "description": "The stage environment configuration that includes services common to all the environment regions.", "locator_id": "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global", "inputs": { "account_id": "ref:/configs/account-stage/inputs/account_id", "resource_group": "stage", "access_tags": [ "env:stage" ], "logdna_name": "The name of the LogDNA stage service instance.", "sysdig_name": "The name of the SysDig stage service instance." } } }, { "definition": { "name": "region-us-south-stage", "description": "The stage us-south configuration.", "locator_id": "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global" } }, { "definition": { "name": "region-eu-de-stage", "description": "The stage eu-de configuration.", "locator_id": "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global", "inputs": { "account_id": "ref:/configs/account-stage/inputs/account_id", "resource_group": "ref:/configs/env-stage/outputs/resource_group_id", "logdna_id": "ref:/configs/env-stage/outputs/logdna_id", "sysdig_id": "ref:/configs/env-stage/outputs/sysdig_id", "access_tags": [ "region:eu-de" ] } } } ], "location": "us-south", "resource_group": "Default" }' \
  "{base_url}/v1/projects"

Hinzufügen einer einsatzfähigen Architektur zu einem Projekt mit Hilfe der API

Sie können einem vorhandenen Projekt programmgesteuert eine verteilbare Architektur hinzufügen, indem Sie die Projekt-API aufrufen und die Konfiguration anpassen, wie in der folgenden Beispielanforderung gezeigt:

curl -X POST --location --header "Authorization: Bearer {iam_token}" \
   --header "Accept: application/json" \
   --header "Content-Type: application/json" \
   --data '{ "definition": { "name": "env-stage", "description": "The stage environment configuration.", "locator_id": "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global", "inputs": { "account_id": "account_id", "resource_group": "stage", "access_tags": [ "env:stage" ], "logdna_name": "LogDNA_stage_service", "sysdig_name": "SysDig_stage_service" } } }' \
   "{base_url}/v1/projects/{project_id}/configs"

Um die Projektinformationen außerhalb des Dienstes IBM Cloud Projects zu sichern, können Sie das Projekt exportieren. Weitere Informationen finden Sie unter Projekt JSON.