Repository erstellen und klonen

Repository erstellen und klonen

Erstellen Sie ein Repository in Secure Source Manager und klonen Sie es auf Ihren lokalen Computer.

Hinweis

1. Erstellen Sie eine Secure Source Manager-Instanz oder fordern Sie Zugriff darauf an. Weitere Informationen finden Sie unter Secure Source Manager-Instanz erstellen.

2. Installieren Sie die Google Cloud CLI.

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

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

   gcloud init

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen eines Repositorys benötigen:

• Rolle „Ersteller von Secure Source Manager-Instanz-Repositories“ (roles/securesourcemanager.instanceRepositoryCreator) für die Secure Source Manager-Instanz
• Rolle „Ersteller von Secure Source Manager-Repositories“ (roles/securesourcemanager.repoCreator) für das Instanzprojekt

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

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 und Klonen eines Repositorys. In einer Produktionsumgebung sollten Sie keine Administratorrollen oder einfachen Rollen zuweisen. Sie können sie aber in einer Entwicklungs- oder Testumgebung zuweisen.

Informationen zum Zuweisen von Secure Source Manager-Rollen finden Sie unter Zugriffssteuerung mit IAM und Nutzern Zugriff auf Instanzen gewähren.

Repository erstellen

Weboberfläche

1. Wenn Sie über die Weboberfläche auf die Secure Source Manager-Instanz zugreifen möchten, kopieren Sie die folgende URL in die Adressleiste Ihres Browsers.

   INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

   Ersetzen Sie Folgendes:

   • INSTANCE_ID durch den Instanznamen.
   • PROJECT_NUMBER durch die Projektnummer der Instanz. Google Cloud Informationen zum Identifizieren von Projekten finden Sie unter Projekte identifizieren.
   • LOCATION durch die Region der Instanz.

2. Authentifizieren Sie sich bei Bedarf mit Ihren Secure Source Manager-Anmeldedaten.

3. Klicken Sie rechts oben im Navigationsmenü auf das Symbol + Neues Repository erstellen.

4. Geben Sie die Repository-Details ein:

   1. Repository-ID: Geben Sie einen Namen für das Repository ein.

      Hinweis: Repository-IDs müssen der Namenskonvention für Ressourcen entsprechen. Sie dürfen nur Kleinbuchstaben, Ziffern oder Bindestriche enthalten, müssen mit einem Buchstaben beginnen und können nach dem Erstellen des Repositorys nicht mehr geändert werden.

   2. Beschreibung: Optional. Beschreibung des Repositorys.

      **Achtung** :Geben Sie keine vertraulichen oder personenbezogenen Daten in die Beschreibung oder andere ähnliche Ressourcenfelder ein. Diese Felder werden gemäß den Google Cloud Datenschutzhinweisen als Dienst daten behandelt.

   3. Standardzweig: Name des Standardzweigs.

   4. Repository initialisieren: Optional. Wählen Sie diese Option aus, wenn Sie das Repository initialisieren und die Dateien „.gitignore“, „license“ und „README“ hinzufügen möchten.

   5. .gitignore: Optional. Wählen Sie im Drop-down-Menü aus, welche Dateien nicht verfolgt werden sollen.

   6. license: Optional. Wählen Sie im Drop-down-Menü eine gängige Lizenz aus.

5. Klicken Sie auf Repository erstellen.

Das Repository wird in Ihrer Secure Source Manager-Instanz erstellt.

Die Rolle „Administrator von Secure Source Manager-Repositories“ (roles/securesourcemanager.repoAdmin) wird Ihnen zugewiesen, wenn Sie ein neues Repository erstellen. Es kann bis zu zwei Minuten dauern, bis die neue IAM-Berechtigung wirksam wird. Wenn Sie also beim Zugriff auf das Repository nach der Erstellung einen Berechtigungsfehler erhalten, warten Sie einige Minuten und versuchen Sie es noch einmal.

Die von Ihnen erstellten Repositorys sind in der Secure Source Manager-Weboberfläche auf der Seite Meine Repositorys aufgeführt.

Anmeldedaten einrichten

Fügen Sie den Secure Source Manager-Authentifizierungshelfer Ihrer globalen Git-Konfiguration hinzu, indem Sie den folgenden Befehl ausführen:

Linux

git config --global credential.'https://*.*.sourcemanager.dev'.helper gcloud.sh

Ältere Versionen von Git unterstützen möglicherweise keine Platzhalter. Führen Sie den folgenden Befehl aus, um den Authentifizierungshelfer ohne Platzhalter hinzuzufügen:

git config --global credential.'https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev'.helper gcloud.sh

Windows

git config --global credential.https://*.*.sourcemanager.dev.helper gcloud.cmd

Ältere Versionen von Git unterstützen möglicherweise keine Platzhalter. Führen Sie den folgenden Befehl aus, um den Authentifizierungshelfer ohne Platzhalter hinzuzufügen:

git config --global credential.https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev.helper gcloud.cmd

Ersetzen Sie Folgendes:

• INSTANCE_ID durch den Namen Ihrer Secure Source Manager-Instanz.
• PROJECT_NUMBER durch Ihre Projektnummer. Informationen zum Ermitteln Ihrer Projektnummer finden Sie unter Projekte identifizieren.
• LOCATION durch die Region der Instanz. Weitere Informationen zu Regionen finden Sie unter Standorte.

Der Authentifizierungshelfer verwendet die gcloud CLI, um Ihre Google Cloud Anmeldedaten abzurufen, wenn Sie Git-Befehle mit Secure Source Manager verwenden.

Führen Sie den folgenden gcloud CLI-Befehl aus, um sich nach der ersten Einrichtung der Anmeldedaten noch einmal zu authentifizieren:

gcloud auth login

Repository klonen

1. Rufen Sie in der Secure Source Manager-Weboberfläche die Seite Ihres Repositorys auf.

2. Kopieren Sie die HTTPS-URL oben auf der Repository-Seite.

3. Klonen Sie Ihr Repository mit dem folgenden Befehl:

   git clone REPOSITORY_URL
   

   Dabei ist REPOSITORY_URL die HTTPS-URL, die oben auf der Repository-Seite angezeigt wird, die Sie klonen möchten.

   Ignorieren Sie die Warnung hinsichtlich des Klonens eines leeren Repositorys.

Push zu einem Repository

1. Wechseln Sie in einem Terminalfenster in das Verzeichnis Ihres geklonten Repositorys.

   cd REPOSITORY_NAME
   

   Dabei ist REPOSITORY_NAME der Name Ihres Repositorys.

2. Erstellen Sie eine leere README-Datei:

   touch README.md
   

3. Fügen Sie die README-Datei zu Git hinzu und erstellen Sie eine Commit-Nachricht:

   git add README.md
   git commit -m "initial commit"
   

4. Übertragen Sie die Änderungen per Push in Ihr Remote-Repository:

   git push -u origin main
   

   Git überträgt die Datei per Push aus dem Hauptzweig in das Remote-Repository „origin“. Die Ausgabe sieht etwa so aus:

   Enumerating objects: 3, done.
   Counting objects: 100% (3/3), done.
   Writing objects: 100% (3/3), 211 bytes | 211.00 KiB/s, done.
   Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
   remote: . Processing 1 references
   remote: Processed 1 references in total
   To https://instance-id-123456789012-git.us-central1.sourcemanager.dev/my-project/my-repo.git
   * [new branch]      main -> main
   branch 'main' set up to track 'origin/main'.
   

Dateien in Secure Source Manager ansehen

Klicken Sie in der Secure Source Manager-Weboberfläche auf den Namen Ihres Repositorys.

Die Repository-Seite wird geöffnet und die Datei README.md ist auf dem <> Code Tab aufgeführt.

Bereinigen

Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud -Konto die auf dieser Seite verwendeten Ressourcen in Rechnung gestellt werden:

Prüfen Sie vor dem Entfernen des Repositorys, ob alle Dateien, die Sie beibehalten möchten, an einem anderen Speicherort verfügbar sind.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: die Projekt-ID des Google Cloud-Projekts, in dem Secure Source Manager ausgeführt wird.
• LOCATION: die Region, in der sich Ihre Instanz befindet. Informationen zu unterstützten Standorten finden Sie unter Standorte.
• REPOSITORY_ID: die Repository-ID.

HTTP-Methode und URL:

DELETE https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

"name":"operations/cc3ea26c-9b57-11ed-be0a-2e3b5910efef","metadata":{"@type":"type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata","createTime":"2023-01-23T19:54:49.904779921Z","endTime":"2023-01-23T19:54:50.947030402Z","target":"projects/my-project/locations/us-central1/repositories/my-repo","verb":"delete","apiVersion":"v1"},"done":true,"response":{"@type":"type.googleapis.com/google.protobuf.Empty"}
```

Die Antwort sieht in etwa so aus:

{"name":"operations/cc3ea26c-9b57-11ed-be0a-2e3b5910efef","metadata":{"@type":"type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata","createTime":"2023-01-23T19:54:49.904779921Z","endTime":"2023-01-23T19:54:50.947030402Z","target":"projects/my-project/locations/us-central1/repositories/my-repo","verb":"delete","apiVersion":"v1"},"done":true,"response":{"@type":"type.googleapis.com/google.protobuf.Empty"}

Nächste Schritte

• Repositorys auflisten und ansehen in der Secure Source Manager-Weboberfläche.
• Mit Pull-Anfragen und Problemen in Secure Source Manager arbeiten