Ein Beispiel-Repository ist ein Git-Repository, das von Ihnen erstellte, benutzerdefinierte Beispiele enthält, mit denen Ihr Team Anwendungen entwickeln kann.
Das bedeutet, dass Sie innerhalb einer Organisation oder eines Teams Beispiel-Repositories mit Cloud Code erstellen können, die speziell auf Ihre Organisation zugeschnitten sind, um eine Reihe von Startanwendungen, -diensten und -infrastrukturkonfiguration zur Verfügung zu stellen, die von anderen genutzt werden können. So können neue Projekte besser auf die bevorzugten technischen Aspekte und Standards Ihrer Organisation abgestimmt werden. Außerdem werden zu Beginn des Entwicklungszyklus Best Practices gefördert.
Ein Beispiel-Repository kann ein vorhandenes Repository von Beispielanwendungen sein, die Sie bereits erstellt haben, oder eine neue Gruppe von Beispielen, die andere verwenden sollen. Zum Importieren eines Repositorys mit Cloud Code fügen Sie dem Repository eine Beispieldeskriptordatei hinzu.
Wenn sie fertig sind, können Sie die Beispiel-Repositories ganz einfach für Ihr Team freigeben. Dazu müssen Sie Cloud Code einrichten und die Git-URL des zu verwendenden Beispiel-Repositories angeben. Bei privaten Git-Repositories können nur Mitglieder, die Zugriff auf das Repository haben, die zugrunde liegenden benutzerdefinierten Beispiele verwenden.
Ein Beispiel für das Einrichten eines Beispiel-Repositorys finden Sie in diesem Repository.
Hinweise
Prüfen Sie, ob Git Version 2.25.0 oder höher auf Ihrem lokalen Computer installiert ist.
Beispiel-Repository erstellen
Wenn Sie ein vorhandenes Repository verwenden möchten, fahren Sie mit Beispieldeskriptordatei erstellen fort. So erstellen Sie ein neues Repository, das als Beispiel-Repository verwendet werden soll:
Erstellen Sie ein neues Git-Repository.
Ihr Git-Repository kann remote oder live auf Ihrem lokalen Computer gehostet werden. In diesem Beispiel wird das neue GitHub-Repository „custom-sample-repo“ verwendet.
Fügen Sie dem Repository Beispielverzeichnisse hinzu.
Ihre Beispielverzeichnisse können beliebige Elemente enthalten und sich an einer beliebigen Stelle im Repository befinden. In diesem Beispiel wurden dem Verzeichnis „custom-sample-repo“ die beiden Beispielverzeichnisse „hello-world“ und „kubernetes-custom-sample“ hinzugefügt.
Eine Readme-Datei mit Anweisungen zur optimalen Verwendung Ihrer benutzerdefinierten Beispiele wird dringend empfohlen.
Erstellen Sie eine Beispieldeskriptordatei.
Eine Beispieldeskriptordatei liefert Cloud Code Informationen zu Ihrem Beispiel, damit die Anwendung ordnungsgemäß erstellt werden kann. Diese Datei muss den Namen
.cctemplate
haben, sich in Ihrem Stammverzeichnis befinden und das im Abschnitt Schema für Beispieldeskriptor-Datei definierte Schema haben.Führen Sie die Schritte zum Erstellen einer Anwendung aus einem benutzerdefinierten Beispiel aus, um Ihr benutzerdefiniertes Beispiel zu testen.
Beispiel für ein Deskriptorschema
Schlüssel | Beschreibung | Typ |
metadata | Von Cloud Code zum Lesen verwendete Metadaten. Es entspricht dem Metadatenschema. | Metadaten |
Vorlagen | Array von Beispielen in einem Repository. Objekte in diesem Array müssen dem Beispielschema entsprechen. | Array<Sample> |
Name (optional) | Name des Beispiel-Repositorys. | String |
Beispiel
{
"metadata":{
"version":"1"
},
"name": "My Sample Repository",
"templates":[
{
"path":"/path/to/sample1_location",
"name":"My Sample 1",
"description":"The first sample of its name."
},
{
"path":"/path/to/sample2_location",
"name":"My Sample 2",
"description":"The sequel."
}
]
}
Beispielschema
Schlüssel | Beschreibung | Typ |
Pfad | Der Speicherort des Beispiels in einem Repository. Der Pfad ist relativ zum Stammverzeichnis des Repositorys. |
String |
name | Name eines Beispiels. Der Name wird in einer IDE angezeigt, wenn ein Beispiel ausgewählt wird, auf dem eine Anwendung basieren soll. |
String |
Beschreibung (optional) | Beschreibung eines Beispiels. Die Beschreibung wird in einer IDE angezeigt, wenn ein Beispiel ausgewählt wird, auf dem eine Anwendung basieren soll. |
String |
Beispiel
{
"path":"path/to/sample1",
"name":"My Sample 1",
"description":"The first sample of its name."
}
Metadaten-Schema
Schlüssel | Beschreibung | Typ |
version | Die Version des Beispielschemas, das verwendet werden soll. Die einzige gültige Version ist 1 .
|
String |
Beispiel
{
"version":"1"
}
Benutzerdefiniertes Beispiel-Repository löschen
So löschen Sie ein benutzerdefiniertes Beispiel, wodurch es aus dem Fluss des benutzerdefinierten Anwendungsselektors und von den Computern der Nutzer entfernt wird:
Suchen Sie in der Datei
settings.json
nachlocalPath
für den benutzerdefinierten Beispieleintrag."cloudcode.customApplications": [ { "repoUrl": https://github.com/GoogleCloudPlatform/cloud-code-custom-samples-example.git, "branchName": "", "localPath": "/Users/username/Library/cloud-code/custom-templates/https-github-com-google-cloud-platform-cloud-code-custom-samples-example-git" } ],
Löschen Sie den Vorlagenordner im Pfad.
Löschen Sie den benutzerdefinierten Beispielabschnitt aus der Datei
settings.json
.
Benutzerdefiniertes Beispiel-Repository löschen
So löschen Sie ein benutzerdefiniertes Beispiel-Repository aus Cloud Code:
Rufen Sie Einstellungen > Tools > Cloud Code > Benutzerdefinierte Beispiele auf.
Wählen Sie in der Tabelle Benutzerdefinierte Beispiel-Repositories die Repository-URL aus, die Sie entfernen möchten, und klicken Sie auf - Entfernen.
Klicken Sie im angezeigten Bestätigungsdialogfeld auf Entfernen, um das ausgewählte Repository aus Cloud Code zu löschen.