Instanz erstellen und darauf zugreifen

Instanz erstellen und darauf zugreifen

Erstellen Sie eine Secure Source Manager-Instanz und greifen Sie auf die zugehörige Weboberfläche zu, um das Erstellen von Repositories und das Gewähren von Nutzerzugriff vorzubereiten.

Hinweis :Secure Source Manager unterstützt keine auf Domains beschränkten Projekte. Wenn Ihre Projekt-ID einen Doppelpunkt (:) enthält, müssen Sie ein neues Projekt erstellen, bevor Sie Secure Source Manager verwenden können.

Hinweis

Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

Installieren Sie die Google Cloud CLI.

Hinweis:Wenn Sie die gcloud CLI zuvor installiert haben, prüfen Sie, ob Sie die aktuelle Version haben, indem Sie gcloud components update ausführen.

Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren:

gcloud init

Erstellen Sie ein Google Cloud Projekt oder wählen Sie eines aus.

Rollen, die zum Auswählen oder Erstellen eines Projekts erforderlich sind

• Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können jedes Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
• Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Projektersteller“ (roles/resourcemanager.projectCreator), die die Berechtigung resourcemanager.projects.create enthält. Weitere Informationen zum Zuweisen von Rollen

Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

• So erstellen Sie ein Google Cloud Projekt:

  gcloud projects create PROJECT_ID

  Ersetzen Sie PROJECT_ID durch einen Namen für das Google Cloud Projekt, das Sie erstellen.

• Wählen Sie das von Ihnen erstellte Google Cloud Projekt aus:

  gcloud config set project PROJECT_ID

  Ersetzen Sie PROJECT_ID durch den Namen Ihres Projekts in Google Cloud .

Prüfen Sie, ob die Abrechnung für Ihr Google Cloud Projekt aktiviert ist.

Aktivieren Sie die Secure Source Manager API:

Rollen, die zum Aktivieren von APIs erforderlich sind

Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Weitere Informationen zum Zuweisen von Rollen

gcloud services enable securesourcemanager.googleapis.com

Installieren Sie die Google Cloud CLI.

Hinweis:Wenn Sie die gcloud CLI zuvor installiert haben, prüfen Sie, ob Sie die aktuelle Version haben, indem Sie gcloud components update ausführen.

Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren:

gcloud init

Erstellen Sie ein Google Cloud Projekt oder wählen Sie eines aus.

Rollen, die zum Auswählen oder Erstellen eines Projekts erforderlich sind

• Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können jedes Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
• Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Projektersteller“ (roles/resourcemanager.projectCreator), die die Berechtigung resourcemanager.projects.create enthält. Weitere Informationen zum Zuweisen von Rollen

Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

• So erstellen Sie ein Google Cloud Projekt:

  gcloud projects create PROJECT_ID

  Ersetzen Sie PROJECT_ID durch einen Namen für das Google Cloud Projekt, das Sie erstellen.

• Wählen Sie das von Ihnen erstellte Google Cloud Projekt aus:

  gcloud config set project PROJECT_ID

  Ersetzen Sie PROJECT_ID durch den Namen Ihres Projekts in Google Cloud .

Prüfen Sie, ob die Abrechnung für Ihr Google Cloud Projekt aktiviert ist.

Aktivieren Sie die Secure Source Manager API:

Rollen, die zum Aktivieren von APIs erforderlich sind

Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Weitere Informationen zum Zuweisen von Rollen

gcloud services enable securesourcemanager.googleapis.com

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Instance Owner (roles/securesourcemanager.instanceOwner) für das Projekt Google Cloud zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen einer Secure Source Manager-Instanz benötigen.

Hinweis :Die Rolle „Secure Source Manager-Administrator“ (roles/securesourcemanager.admin) oder die einfache IAM-Rolle „Inhaber“ (roles/owner) für Ihr Projekt enthält auch Berechtigungen zum Erstellen einer Instanz. In einer Produktionsumgebung sollten Sie keine Administratorrollen oder einfachen Rollen zuweisen, Sie können sie aber in einer Entwicklungs- oder Testumgebung gewähren.

Secure Source Manager-Rollen werden erst in der Google Cloud Console angezeigt, wenn sie einem Hauptkonto zugewiesen wurden. Informationen zum erstmaligen Zuweisen einer Secure Source Manager-Rolle finden Sie unter IAM-Rollen zuweisen und aufheben.

Instanz erstellen

1. Führen Sie den folgenden Befehl aus, um eine Instanz mit dem Namen my-instance am us-central1-Standort zu erstellen. Möglicherweise werden Sie aufgefordert, sich bei der gcloud CLI zu authentifizieren.

   gcloud source-manager instances create my-instance \
       --region=us-central1
   

   Wobei:

   • my-instance ist der Name der Instanz.
   • us-central1 ist die Region, in der Sie die Instanz erstellen.

   Ein Vorgang mit langer Ausführungszeit zum Erstellen einer Instanz wird gestartet. Die Ausgabe sieht dann ungefähr so aus:

   Create request issued for [my-instance].
   done: false
   metadata:
     '@type': type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata
     apiVersion: v1
     createTime: '2023-02-27T20:57:52.315609549Z'
     requestedCancellation: false
     target: projects/PROJECT_ID/locations/us-central1/instances/my-instance
     verb: create
   name: projects/PROJECT_ID/locations/us-central1/operations/operation-1234567894561-5ec69948c0f2b-60dd727f-a9b97a2e
   

   Das Erstellen der Instanz kann bis zu 60 Minuten dauern.

2. Notieren Sie sich OPERATION_NAME. Das ist der vollständige Ressourcenname des Vorgangs, der als Antwort auf Ihre Anfrage zurückgegeben wurde. Er hat das folgende Format und ist erforderlich, wenn Sie im nächsten Schritt den Status des Vorgangs prüfen:

   projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID

   Beispiel: projects/PROJECT_ID/locations/us-central1/operations/operation-1234567894561-5ec69948c0f2b-60dd727f-a9b97a2e Dabei ist PROJECT_ID Ihr Google Cloud Projekt.

3. Prüfen Sie den Status des Vorgangs create mit dem folgenden Befehl:

   gcloud source-manager operations describe OPERATION_NAME \
       --region=us-central1
   

   Ersetzen Sie OPERATION_NAME durch den Vorgangsnamen, der in der Antwort auf Ihren Erstellungsbefehl zurückgegeben wird.

   Wenn die Instanz bereit ist, sieht die Antwort so aus:

   {
   "name": "projects/PROJECT_ID/locations/us-central1/operations/operation-123456789012-5ec69948c0f2b-60dd727f-a9b97a2e",
   "metadata": {
     "@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata",
     "createTime": "2022-11-01T14:31:32.420469714Z",
     "endTime": "2022-11-01T14:48:34.140378114Z",
     "target": "projects/PROJECT_ID/locations/us-central1/instances/my-instance",
     "verb": "create",
     "requestedCancellation": false,
     "apiVersion": "v1"
   },
   "done": true,
   "response": {
     "@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.Instance",
     "name": "projects/PROJECT_ID/locations/us-central1/instances/my-instance",
     "createTime": "2022-11-01T14:31:32.416413630Z",
     "updateTime": "2022-11-01T14:31:32.416413630Z"
     },
     "state": "ACTIVE",
     "hostConfig": {
       "html": "my-instance-098765432109.us-central1.sourcemanager.dev",
       "api": "my-instance-098765432109-api.us-central1.sourcemanager.dev",
       "gitHttp": "my-instance-098765432109-git.us-central1.sourcemanager.dev"
     }
   }
   }
   

   Wobei:

   • my-instance-098765432109.us-central1.sourcemanager.dev ist die HTML-URL der Instanz.
   • PROJECT_ID ist die Projekt-ID.
   Hinweis :Es ist möglich, dass der Statuscheck den Abschluss meldet, bevor die Instanz vollständig betriebsbereit ist. Wenn beim Zugriff auf die Instanz nach der Erstellung Fehler auftreten, warten Sie 60 Minuten und versuchen Sie es noch einmal, bevor Sie sich unter [e-mail] an den Secure Source Manager-Support wenden.

4. Kopieren Sie die HTML-URL aus dem erfolgreich erstellten Befehl zum Prüfen des Status. Sie benötigen diese URL, um über einen Webbrowser auf die Instanz zuzugreifen.

Auf eine Instanz zugreifen

Nachdem die Instanz erstellt wurde, können Sie über das Webinterface mit einem Browser darauf zugreifen.

Hinweis :Wenn Sie Repositories in der Instanz erstellen möchten, benötigen Sie die Rolle „Repo Creator“ (roles/securesourcemanager.repoCreator) für das Instanzprojekt und die Rolle „Instance Repository Creator“ (roles/securesourcemanager.instanceRepositoryCreator) für die Secure Source Manager-Instanz.

1. Führen Sie den folgenden Befehl noch einmal aus, um die HTML-URL für Ihre Instanz abzurufen:

      gcloud source-manager operations describe OPERATION_NAME \
       --region=us-central1
   

2. Kopieren Sie die HTML-URL aus der Antwort auf den Befehl gcloud source-manager operations describe in die Adressleiste Ihres Browsers.

3. Ein OAuth 2.0-Bildschirm wird angezeigt, auf dem Sie gefragt werden, ob Sie sourcemanager.dev Zugriff auf Ihr Google Cloud -Konto gewähren möchten.

4. Klicken Sie auf den Button Zulassen.

5. Die Secure Source Manager-Weboberfläche wird geöffnet. Sie können Repositorys und alle zugehörigen Probleme und Pull-Anfragen über die Weboberfläche erstellen und ansehen.

Bereinigen

Löschen Sie das Projekt von Google Cloud zusammen mit den Ressourcen, damit Ihrem Konto von Google Cloud die auf dieser Seite verwendeten Ressourcen nicht in Rechnung gestellt werden.

Achtung: Das Löschen von Projekten hat folgende Auswirkungen:

• Alle Inhalte des Projekts werden gelöscht. Wenn Sie für die Aufgaben in diesem Dokument ein bereits bestehendes Projekt verwendet haben und dieses löschen, werden auch alle anderen im Rahmen des Projekts erstellten Daten gelöscht.
• Benutzerdefinierte Projekt-IDs gehen verloren. Beim Erstellen dieses Projekts haben Sie möglicherweise eine benutzerdefinierte Projekt-ID erstellt, die Sie weiterhin verwenden möchten. Damit die URLs, die die Projekt-ID nutzen, zum Beispiel eine appspot.com-URL, erhalten bleiben, sollten Sie ausgewählte Ressourcen innerhalb des Projekts löschen, anstatt das gesamte Projekt.

Wenn Sie mehrere Architekturen, Anleitungen und Kurzanleitungen durcharbeiten möchten, können Sie die Überschreitung von Projektkontingenten verhindern, indem Sie Projekte wiederverwenden.

1. Wechseln Sie in der Google Cloud -Console zur Seite Ressourcen verwalten.

   Zur Seite „Ressourcen verwalten“

2. Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen.
3. Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Shut down (Beenden), um das Projekt zu löschen.

Nächste Schritte

• Repository erstellen und klonen
• Nutzern Instanzzugriff gewähren
• Repository-Nutzer hinzufügen