Creación del botón Desplegar en IBM Cloud

El botón Desplegar en IBM Cloud es una forma eficiente de compartir la app de origen Git público con otras personas para que puedan experimentar con el código y desplegarla en IBM Cloud mediante una cadena de herramientas. Este botón requiere una configuración mínima y puede insertarse en cualquier lugar que admita la marcación. El usuario que pulse el botón creará una copia del código en un nuevo repositorio Git (repo), de manera que la app original no se verá afectada.

Cuando el usuario pulsa el botón tienen lugar las siguientes acciones:

El usuario deberá crear una cuenta de IBM Cloud si no dispone de una cuenta activa. Puede crear una cuenta de prueba o una cuenta real.
El usuario puede pulsar el icono Delivery Pipeline para seleccionar una región, un grupo de recursos y un nombre de aplicación. El nombre de app sugerido es el mismo que el nombre de la cadena de herramientas, que se crea a partir del nombre del repositorio Git original y de la hora. El nombre de la cadena de herramientas también se puede editar.
Se crea una cadena de herramientas que incluye un nuevo clon privado del repositorio Git, un conducto para crear y desplegar cambios de código y un rastreador de problemas.

Si el directorio .bluemix contiene un archivo toolchain.yml, el archivo se utilizará para especificar las integraciones de herramientas para la cadena de herramientas. Para obtener más información sobre el archivo toolchain.yml, consulta Creación de plantillas de cadenas de herramientas personalizadas.
Si la app requiere un archivo de compilación, este se detectará automáticamente y se compilará la app.
Si se configura un conducto para el proceso de compilación y de despliegue, se utilizará un archivo pipeline.yml para desplegar la app.
Si la app necesita un contenedor, se utiliza un archivo pipeline.yml que defina el IBM Cloud Kubernetes Service y un Dockerfile que defina una imagen, para desplegar la app en el IBM Cloud Kubernetes Service.
Se desplegará la app en la organización de IBM Cloud que haya seleccionado el usuario.

Ejemplos del botón

DevOps Insights Llegará al final de su vida útil y se dejará de ofrecer el 31 de agosto de 2026. Continuous Delivery dejará de estar disponible en las siguientes regiones el 12 de febrero de 2027: au-syd, ca-tor, us-east. Code Risk Analyzer también dejará de estar disponible en todas las regiones a partir de esa fecha. Si en una región no se hace un uso activo de estas funciones, es posible que dichas funciones se retiren antes de lo previsto en esa región y dejen de aceptar nuevas instancias. Más información

Ejemplo del botón de la app de un repositorio Git Repos and Issue Tracking público:

Ejemplo del botón de la app de un repositorio GitHub público:

Creación de un botón

Para crear el botón Desplegar en IBM Cloud, copie y modifique una de las siguientes plantillas de fragmento de código. Especifique un repositorio de Git y una rama en el URL.

Creación de un botón en HTML

Para crear un botón en HTML, copie este fragmento de código e inserte un URL y una rama de repositorio de Git públicos.

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

Si no incluye el parámetro branch en el URL de repositorio del fragmento de código, el botón Desplegar en IBM Cloud tendrá como valor predeterminado la rama maestra del repositorio.

Creación de un botón en Markdown

Para crear un botón en Markdown, copie este fragmento de código e inserte un URL y una rama de repositorio de Git públicos.

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

Si no incluye el parámetro branch en el URL de repositorio del fragmento de código, el botón Desplegar en IBM Cloud tendrá como valor predeterminado la rama maestra del repositorio.

Uso del fragmento de código del botón

Una vez que cree un fragmento de código del botón Desplegar en IBM Cloud, puede insertarlo en blogs, artículos, wikis, archivos léame, o en cualquier otro lugar que desee para promocionar su app.

Al personalizar el fragmento de código para el botón Deploy to IBM Cloud, ten en cuenta que ambas plantillas utilizan una ruta predeterminada a una imagen de botón externa en formato SVG y en inglés. Si prefiere almacenar la imagen localmente, puede descargarla y almacenarla en el repositorio de Git. Ajuste la vía de acceso para utilizar la ubicación relativa de la imagen.

Consideraciones sobre el repositorio

Revise estas consideraciones del repositorio que se utiliza en el botón Desplegar en IBM Cloud.

Requisitos del archivo de compilación

Si la app debe compilarse antes de que se pueda desplegar, debe incluir un archivo de compilación en el repositorio. Si se detecta un archivo script de construcción en el directorio raíz del repositorio, se desencadenará una compilación automatizada del código antes del despliegue.

Entre los compiladores soportados se incluye:

Ant: build.xml, que genera los resultados en la carpeta ./output/
Gradle: /build.gradle, que genera los archivos de salida en la carpeta .
Grunt: /Gruntfile.js, que genera los archivos de salida en la carpeta .
Maven: /pom.xml, que genera los archivos de salida en la carpeta ./target/

Requisitos del archivo de conducto

Para configurar el conducto para la cadena de herramientas en un directorio .bluemix, incluya un archivo pipeline.yml. Para cada archivo pipeline.yml del directorio, se creará un conducto cuando se cree una instancia de la cadena de herramientas.

Para crear un archivo de pipeline, consulta el archivo de ejemplo que aparece en la documentación « Creación de plantillas de cadenas de herramientas personalizadas ». En el momento en que defina un conducto en la interfaz web, defina un conducto en el texto creando etapas y trabajos, estableciendo entradas y variables de entorno y añadiendo scripts. En este proyecto de demostración también puedes ver varios archivos de pipeline más complejos.

Requisitos del Dockerfile del contenedor

Para desplegar una app en un contenedor utilizando el IBM Cloud Kubernetes Service, debe incluir un Dockerfile en el directorio raíz del repositorio y, en un directorio .bluemix, incluya un archivo pipeline.yml.

El Dockerfile actúa como un tipo de script de construcción para la app. Si se detecta un Dockerfile en el repositorio, la app se creará automáticamente en una imagen antes de que se despliegue en un contenedor. Si la propia app debe compilarse antes de que la app se compile en una imagen, incluya un script de compilación para la app y un Dockerfile.

Para obtener más información sobre cómo crear archivos Dockerfile, consulta la documentación de Docker. Para obtener más información sobre Kubernetes, consulte Servicio de KuberenetesIBM Cloud.

Para crear una guía manualmente pipeline.yml específica para contenedores, consulta los ejemplos en GitHub.