Creazione di un pulsante Distribuisci a IBM Cloud

Il pulsante Distribuisci a IBM Cloud è un modo efficace per condividere la tua applicazione originata da Git pubblica in modo che altri utenti possano sperimentarne il codice ed eseguirne la distribuzione a IBM Cloud utilizzando una toolchain. Il pulsante richiede una configurazione minima e puoi inserirlo dovunque siano supportate le markup. Un utente che fa clic sul pulsante crea una copia clonata del codice in un nuovo repository Git in modo che la tua applicazione originale rimanga inalterata.

Quando qualcuno fa clic sul tuo pulsante, si verificano le seguenti azioni:

Se la persona non ha un account IBM Cloud attivo, deve creare un account. Può creare un account di prova o un account reale.
L'utente può selezionare una regione, un gruppo di risorse e il nome dell'app facendo clic sull'icona " Delivery Pipeline ". Il nome suggerito per l'applicazione è uguale al nome della toolchain, che viene creato dal nome del tuo repository Git originale e dell'ora. Il nome della toolchain può anche essere modificato.
Viene creata una toolchain che include un nuovo clone privato del tuo repository Git, una pipeline per la creazione e la distribuzione delle modifiche del codice e un tracker dei problemi.

Se la directory .bluemix contiene un file toolchain.yml, questo file viene utilizzato per specificare le integrazioni dello strumento per la toolchain. Per ulteriori informazioni sul file toolchain.yml , consultare la sezione Creazione di modelli personalizzati per la toolchain.
Se l'applicazione richiede un file di build, esso viene rilevato automaticamente e l'applicazione viene creata.
Se una pipeline viene configurata per il processo di creazione e di distribuzione, viene utilizzato un file pipeline.yml per distribuire l'applicazione.
Se l'applicazione richiede un contenitore, viene utilizzato un file pipeline.yml che definisce IBM Cloud Kubernetes Service e un Dockerfile che definisce un'immagine per distribuire l'applicazione in IBM Cloud Kubernetes Service.
L'applicazione viene distribuita all'organizzazione IBM Cloud selezionata dalla persona.

Esempi del pulsante

DevOps Insights Il servizio giungerà al termine e verrà interrotto il 31 agosto 2026. Il servizio " Continuous Delivery " verrà interrotto nelle seguenti regioni il 12 febbraio 2027: au-syd, ca-tor, us-east. A partire da tale data, anche Code Risk Analyzer verrà ritirato dal mercato in tutte le regioni. Se in una regione non si riscontra un utilizzo attivo di queste funzionalità, queste potrebbero essere dismesse in anticipo e non accettare più nuove istanze. Per saperne di più

Vedi un esempio di pulsante dell'applicazione per un repository Git Repos and Issue Tracking pubblico:

Vedi un esempio di pulsante dell'applicazione per un repository GitHub pubblico:

Creazione di un pulsante

Per creare un pulsante Distribuisci a IBM Cloud, copia e modifica uno dei seguenti template di frammento. Specifica un repository e un ramo Git nell'URL.

Creazione di un pulsante in HTML

Per creare un pulsante in HTML, copia questo frammento e inserisci un ramo e URL del repository Git pubblico.

<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>

Se non includi il parametro branch nell'URL del repository del frammento, il pulsante Distribuisci a IBM Cloud utilizza come valore predefinito il ramo principale del repository.

Creazione di un pulsante in Markdown

Per creare un pulsante in Markdown, copia questo frammento e inserisci un ramo e URL del repository Git pubblico.

[![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>)

Se non includi il parametro branch nell'URL del repository del frammento, il pulsante Distribuisci a IBM Cloud utilizza come valore predefinito il ramo principale del repository.

Utilizzo dei frammenti del pulsante

Dopo aver creato un frammento di pulsante Distribuisci a IBM Cloud, puoi inserirlo in blog, articoli, wiki, file readme o ovunque tu voglia promuovere la tua applicazione.

Quando personalizzi lo snippet per il pulsante "Deploy to IBM Cloud ", tieni presente che entrambi i modelli utilizzano un percorso predefinito che rimanda a un'immagine esterna del pulsante in formato SVG e in lingua inglese. Se preferisci memorizzare l'immagine localmente, puoi scaricare l'immagine e memorizzarla nel repository Git. Regola il percorso per utilizzare l'ubicazione relativa dell'immagine.

Considerazioni sul repository

Consulta queste considerazioni per il repository che utilizzi nel tuo pulsante Distribuisci a IBM Cloud.

Requisiti dei file di build

Se occorre creare l'applicazione prima che possa essere distribuita, devi includere un file di build nel tuo repository. Se viene rilevato un file script di build nella directory root del repository, viene attivato un build automatico del codice prima della distribuzione.

I builder supportati includono:

Ant: build.xml, che genera i file di output nella cartella ./output/
Gradle: /build.gradle, che genera i file di output nella cartella .
Grunt: /Gruntfile.js, che genera i file di output nella cartella .
Maven: /pom.xml, che genera i file di output nella cartella ./target/

Requisiti dei file pipeline

Per configurare la pipeline per la toolchain in una directory .bluemix, includi un file pipeline.yml. Per ogni file pipeline.yml in tale directory, viene creata una pipeline dopo aver istanziato la toolchain.

Per creare un file di pipeline, consultare il file di esempio riportato nella documentazione " Creazione di modelli personalizzati per la toolchain ". Come quando definisci una pipeline nell'interfaccia web, definisci una pipeline in testo creando fasi e lavori, impostando input e variabili di ambiente e aggiungendo script. In questo progetto dimostrativo è inoltre possibile visionare una serie di file di pipeline più complessi.

Requisiti dei Dockerfile di contenitore

Per distribuire un'applicazione in un contenitore utilizzando IBM Cloud Kubernetes Service, devi includere un Dockerfile nella directory root del repository e, in una directory .bluemix, devi includere un file pipeline.yml.

Il Dockerfile agisce come una sorta di script di build per l'applicazione. Se un Dockerfile viene rilevato nel repository, l'applicazione viene integrata automaticamente in un'immagine prima che venga distribuita in un contenitore. Se la stessa applicazione deve essere creata prima di essere integrata in un'immagine, includi uno script di build per l'applicazione e un Dockerfile.

Per ulteriori informazioni sulla creazione dei file Dockerfile, consulta la documentazione su “ Docker ”. Per ulteriori informazioni su Kubernetes, vedi IBM Cloud Kuberenetes Service.

Per creare manualmente un file pipeline.yml specifico per i container, consultare gli esempi disponibili all'indirizzo GitHub.