Repository erstellen

Auf dieser Seite wird beschrieben, wie Sie ein Repository über die Secure Source Manager-Weboberfläche oder die Secure Source Manager API erstellen.

Wenn Ihre Secure Source Manager-Instanz noch nicht erstellt wurde, lesen Sie den Artikel Secure Source Manager-Instanz erstellen, um loszulegen.

Hinweis

Erstellen Sie eine Secure Source Manager-Instanz oder fordern Sie Zugriff darauf an. Weitere Informationen finden Sie unter Secure Source Manager-Instanz erstellen.
Installieren Sie die Google Cloud CLI.
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
```
Installieren Sie die beta-Komponente der Google Cloud CLI:
```
gcloud components install alpha
```

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.

Informationen zum Zuweisen von Secure Source Manager-Rollen, siehe Zugriffssteuerung mit IAM und Nutzern Instanzzugriff gewähren.

Repository erstellen

Weboberfläche

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.
Authentifizieren Sie sich bei Bedarf mit Ihren Secure Source Manager-Anmeldedaten.
Klicken Sie rechts oben im Navigationsmenü auf das Symbol + Neues Repository erstellen.
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 Datenschutzhinweisenals 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.
Klicken Sie auf Repository erstellen.

gcloud

Erstellen Sie ein Repository mit der gcloud CLI, indem Sie den folgenden Befehl ausführen:
```
gcloud source-manager repos create REPOSITORY_ID \
    --region=LOCATION \
    --project=PROJECT_ID \
    --instance=INSTANCE_ID \
    --description=DESCRIPTION \
    --default-branch=BRANCH \
    --gitignores=GITIGNORES \
    --license=LICENSE \
    --readme=README
```
Ersetzen Sie Folgendes:
- REPOSITORY_ID durch den Namen für Ihr Repository.
  
  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.
- LOCATION durch die Region, in der Sie das Repository erstellen möchten. Informationen zu unterstützten Standorten finden Sie unter Standorte.
- PROJECT_ID durch die Projekt-ID der Secure Source Manager-Instanz, in der Sie das Repository erstellen möchten.
- INSTANCE_ID durch die Instanz-ID der Instanz, in der Sie das Repository erstellen. Informationen zum Auflisten der Secure Source Manager-Instanzen in Ihrem Projekt finden Sie unter Instanzen auflisten und ansehen.
- DESCRIPTION durch eine Beschreibung des Repositorys. Dies ist optional und kann weggelassen werden.
  
  **Achtung** :Geben Sie keine vertraulichen oder personenbezogenen Daten in die Beschreibung oder andere ähnliche Ressourcenfelder ein. Diese Felder werden gemäß den Google Cloud Datenschutzhinweisenals Dienst Daten behandelt.
- BRANCH durch den Standardzweignamen. Dies ist optional und kann weggelassen werden. Wenn kein Standardzweigname festgelegt ist, wird main verwendet.
- GITIGNORES durch eine durch Kommas getrennte Liste von Namen für „.gitignore“-Vorlagen. Dies ist optional und kann weggelassen werden. Die vollständige Liste der verfügbaren Vorlagen finden Sie in der Konfigurationsreferenz für die Repository-Initialisierung.
- LICENSE durch den Namen der Lizenzvorlage, die auf Ihr Repository angewendet werden soll. Dies ist optional und kann weggelassen werden. Die vollständige Liste der verfügbaren Lizenzvorlagen finden Sie in der Konfigurationsreferenz für die Repository-Initialisierung.
- README durch default, um eine README-Datei aus der Standardvorlage zu erstellen. Dies ist optional und kann weggelassen werden. Wenn Sie diese Option weglassen, wird keine README-Datei erstellt.

API

Erstellen Sie ein Repository mit einem REST-Aufruf, indem Sie den folgenden Befehl ausführen:

curl \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/repositories?repository_id=REPOSITORY_ID \
    -d '{"instance": "projects/PROJECT_ID/locations/REGION/instances/INSTANCE_ID"}'

Ersetzen Sie Folgendes:

REGION durch die Region Ihrer Secure Source Manager-Instanz. Informationen zu unterstützten Standorten finden Sie unter Standorte.
INSTANCE_ID durch die ID Ihrer Secure Source Manager-Instanz.
PROJECT_ID durch die Projekt-ID Ihrer Secure Source Manager-Instanz. Informationen zum Ermitteln Ihrer Projekt-ID finden Sie unter Projekte identifizieren.
REPOSITORY_ID durch den Namen für Ihr Repository.

Mit dem HTTP POST-Daten-Flag, -d'{}' können zusätzliche Werte angegeben werden, z. B. zum Initialisieren des Repositorys oder zum Hinzufügen einer bestimmten .gitignore Datei oder von Lizenzen. Weitere Informationen finden Sie in der Referenzdokumentation.

Wenn die Ausgabe für Menschen lesbar sein soll, können Sie sie mit json_pp in JSON umwandeln.

Beispiel:

curl \
    -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    https://securesourcemanager.googleapis.com/v1/projects/my-project-id/locations/us-central1/repositories?repository_id=my-repo \
    -d '{"instance": "projects/my-project-id/locations/us-central1/instances/prod-test-instance", "initialConfig":{"defaultBranch":"main"}}' | json_pp

Die Antwort sieht in etwa so aus:

{
  "name": "operations/266bf4c7-13fe-11ed-be24-da823b7355d0",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata",
    "createTime": "2022-08-04T14:02:59.810496928Z",
    "endTime": "2022-08-04T14:03:00.558354528Z",
    "target": "projects/654987321654/locations/us-central1/repositories/my-repo",
    "verb": "create",
    "apiVersion": "v1"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.Repository",
    "name": "projects/my-project-id/locations/us-central1/repositories/my-repo",
    "instance": "projects/654987321654/locations/us-central1/instances/prod-test-instance",
    "createTime": "2022-08-04T14:03:00Z",
    "uris": {
      "html": "https://prod-test-instance-654987321654.us-central1.sourcemanager.dev/my-project-id/my-repo",
      "gitHttps": "https://prod-test-instance-654987321654-git.us-central1.sourcemanager.dev/my-project-id/my-repo.git"
    }
}

Wobei:

654987321654 die Projektnummer des Repositorys ist.
my-project-id die Projekt-ID des Repositorys ist.
my-repo die REPOSITORY_ID ist, die Sie im Befehl zum Erstellen festgelegt haben. Das Feld uris enthält die URLs für den Zugriff auf das Repository über den Webbrowser oder über das Git-Protokoll mit HTTPS-Zugriff.

Greifen Sie mit der HTML-URI in der Antwort auf Ihr neues Repository zu. Die Codeüberprüfung, das Problem-Tracking und Pull-Anfragen werden in der Secure Source Manager-Weboberfläche unterstützt.

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

Die Rolle „Repository-Administrator“ (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 dem Erstellen einen Berechtigungsfehler erhalten, warten Sie einige Minuten und versuchen Sie es noch einmal.

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

Nächste Schritte

Nutzern Repository-Zugriff gewähren
Git-Quellcodeverwaltung verwenden mit Secure Source Manager.
Repositories in der Secure Source Manager-Weboberfläche auflisten und ansehen.

Repository erstellen Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Hinweis

Erforderliche Rollen

Repository erstellen

Weboberfläche

gcloud

API

Nächste Schritte

Repository erstellen