Schaltfläche zum Bereitstellen in IBM Cloud erstellen

Die Schaltfläche zum Bereitstellen in IBM Cloud bietet ein effizientes Verfahren, Ihre öffentliche Git-basierte App für die gemeinsame Nutzung bereitzustellen, sodass andere Anwender mit dem Code experimentieren und ihn in IBM Cloud unter Verwendung einer Toolchain bereitstellen können. Die Schaltfläche erfordert nur minimalen Konfigurationsaufwand und Sie können sie überall dort einfügen, wo Markup unterstützt wird. Beim Anklicken dieser Schaltfläche wird eine geklonte Kopie des Codes in einem neuen Git-Repository (Repo) erstellt, d. h., Ihre ursprüngliche App bleibt unverändert.

Wenn ein Benutzer auf die Schaltfläche klickt, werden die folgenden Aktionen ausgeführt:

Wenn der Benutzer nicht über ein aktives IBM Cloud-Konto verfügt, muss er ein Konto erstellen. Es kann ein Testkonto oder ein reales Konto erstellt werden.
Die Person kann eine Region, eine Ressourcengruppe und einen App-Namen auswählen, indem sie auf das Symbol Delivery Pipeline klickt. Der empfohlene App-Name ist identisch mit dem Toolchain-Namen, der sich aus dem Namen Ihres ursprünglichen Git-Repositorys und einer Zeitangabe zusammensetzt. Der Name der Toolchain kann auch bearbeitet werden.
Es wird eine Toolchain erstellt, die einen neuen privaten Klon Ihres Git-Repositorys, eine Pipeline zum Erstellen und Implementieren von Codeänderungen und einen Problemtracker enthält.

Wenn das Verzeichnis .bluemix eine Datei toolchain.yml enthält, wird die Datei verwendet, um die Toolintegrationen für die Toolchain anzugeben. Weitere Informationen zu dieser Datei toolchain.yml finden Sie unter Erstellen benutzerdefinierter Toolchain-Vorlagen.
Wenn für die App eine Builddatei erforderlich ist, wird die Builddatei automatisch erkannt und die App wird erstellt.
Wenn eine Pipeline für den Erstellungs- und Bereitstellungsprozess konfiguriert ist, wird eine Datei pipeline.yml verwendet, um die App bereitzustellen.
Wenn für die App ein Container erforderlich ist, werden eine Datei pipeline.yml, die den IBM Cloud Kubernetes Service definiert, und eine Dockerfile, die ein Image definiert, zur Bereitstellung der App im IBM Cloud Kubernetes Service verwendet.
Die App wird in der IBM Cloud-Organisation bereitgestellt, die der Benutzer ausgewählt hat.

Beispiele für die Schaltfläche

DevOps Insights wird am 31. August 2026 das Ende des Betriebs erreichen und eingestellt werden. Continuous Delivery wird am 12. Februar 2027 in den folgenden Regionen eingestellt: au-syd, ca-tor, us-east. Code Risk Analyzer wird zu diesem Zeitpunkt ebenfalls in allen Regionen eingestellt. Wenn diese Funktionen in einer Region nicht aktiv genutzt werden, können sie in dieser Region vorzeitig eingestellt werden, sodass keine neuen Instanzen mehr akzeptiert werden. Weitere Informationen

Das folgende Beispiel zeigt eine App-Schaltfläche für ein öffentliches Git Repos and Issue Tracking-Repository:

Das folgende Beispiel zeigt eine App-Schaltfläche für ein öffentliches GitHub-Repository:

Erstellen einer Schaltfläche

Um eine Schaltfläche für das Bereitstellen in IBM Cloud zu erstellen, kopieren und ändern Sie eine der folgenden Snippetvorlagen. Geben Sie ein Git-Repository und eine Verzweigung in der URL ein.

Schaltfläche in HTML erstellen

Um eine Schaltfläche in HTML zu erstellen, kopieren Sie dieses Snippet und fügen Sie eine öffentliche Git-Repository-URL und eine Verzweigung ein.

<a href="https://cloud.ibm.com/devops/setup/deploy?repository=<git_repository_URL>&branch=<git_branch>"><img src="https://cloud.ibm.com/media/docs/images/icons/Deploy_to_cloud.svg" alt="Deploy to IBM Cloud" target="_blank"></a>

Wenn Sie den Parameter branch nicht in die Repository-URL Ihres Snippets einfügen, wird für die Schaltfläche für die Bereitstellung in IBM Cloud standardmäßig der Masterzweig des Repositorys verwendet.

Schaltfläche in Markdown erstellen

Um eine Schaltfläche in Markdown zu erstellen, kopieren Sie dieses Snippet und fügen Sie eine öffentliche Git-Repository-URL und eine Verzweigung ein.

[![Deploy to IBM Cloud button](https://cloud.ibm.com/media/docs/images/icons/Deploy_to_cloud.svg)](https://cloud.ibm.com/devops/setup/deploy?repository=<git_repository_URL>&branch=<git_branch>)

Snippets für Schaltflächen verwenden

Nachdem Sie ein Snippet für eine Schaltfläche für die Bereitstellung in IBM Cloud erstellt haben, können Sie es in Blogs, Artikel, Wikis, Readme-Dateien oder anderswo einfügen, um für Ihre App zu werben.

Wenn Sie das Snippet für Ihre Schaltfläche IBM Cloud bereitstellen anpassen, beachten Sie bitte, dass beide Vorlagen einen Standardpfad zu einem externen Schaltflächenbild im SVG-Format und in englischer Sprache verwenden. Wenn Sie die Abbildung lieber lokal speichern möchten, können Sie die Abbildung herunterladen und in Ihrem Git-Repository speichern. Passen Sie den Pfad an die relative Position der Abbildung an.

Hinweise zum Repository

Beachten Sie die folgenden Hinweise zu dem Repository, das Sie in Ihrer Schaltfläche für die Bereitstellung in IBM Cloud verwenden.

Erfordernis einer Builddatei

Wenn ein Build der App erforderlich ist, bevor sie bereitgestellt werden kann, müssen Sie eine Builddatei in Ihr Repository einfügen. Wenn eine Build-Script-Datei im Stammverzeichnis des Repositorys erkannt wird, wird ein automatisierter Build des Codes vor der Bereitstellung ausgelöst.

Unterstützte Buildprogramme:

Ant: build.xml, das die Ausgabe in den Ordner ./output/ erstellt
Gradle: /build.gradle, das die Ausgabe im Ordner . erstellt.
Grunt: /Gruntfile.js, das die Ausgabe im Ordner . erstellt
Maven: /pom.xml, das die Ergebnisse im Ordner ./target/ erstellt

Erfordernis einer Pipelinedatei

Um die Pipeline für die Toolchain in einem Verzeichnis .bluemix zu konfigurieren, fügen Sie eine Datei pipeline.yml ein. Für jede Datei pipeline.yml in diesem Verzeichnis wird eine Pipeline erstellt, wenn die Toolchain instanziiert wird.

Um eine Pipeline-Datei zu erstellen, sehen Sie sich die Beispieldatei in der Dokumentation Erstellen benutzerdefinierter Toolchain-Vorlagen an. Genau wie beim Definieren einer Pipeline in der Webschnittstelle definieren Sie eine Pipeline im Text, indem Sie Phasen und Jobs erstellen, Eingaben und Umgebungsvariablen festlegen und Scripts hinzufügen. In diesem Demonstrationsprojekt finden Sie außerdem eine Reihe komplexerer Pipeline-Dateien.

Erfordernis einer Container-Dockerfile

Um eine App in einem Container mithilfe von IBM Cloud Kubernetes Service bereitzustellen, müssen Sie eine Dockerfile in das Stammverzeichnis des Repositorys einfügen und eine Datei .bluemix in ein Verzeichnis pipeline.yml stellen.

Die Dockerfile fungiert als eine Art Build-Script für die App. Wenn eine Dockerfile im Repository festgestellt wird, wird die App automatisch in einem Image erstellt, bevor sie in einem Container bereitgestellt wird. Wenn ein Build der App erforderlich ist, bevor sie in einem Image erstellt werden kann, fügen Sie ein Build-Script für die App und eine Dockerfile hinzu.

Weitere Informationen zum Erstellen von Dockerfiles finden Sie in der Dokumentation zu Docker. Weitere Informationen zu Kubernetesfinden Sie unter IBM Cloud Kuberenetes Service.

Informationen zum Erstellen einer speziell auf Container zugeschnittenen Anleitung pipeline.yml finden Sie in den Beispielen unter GitHub.