Crear una configuración de compilación que extraiga el código fuente de un directorio local
Si el código fuente está en la estación de trabajo local, cree una configuración de compilación con valores que incluyan información sobre dónde extraer el código fuente del directorio local. Para la salida de compilación, puede especificar detalles de registro o dejar que Code Engine gestione los detalles de IBM Cloud Container Registry.
Puede crear una configuración de compilación que extraiga el código fuente de un directorio local utilizando solo la CLI de Code Engine.
Cuando envía una compilación que extrae código de un directorio local, el código fuente se empaqueta en un archivo de archivado y se carga en la instancia de IBM Cloud Container Registry. Tenga en cuenta que solo puede tener IBM Cloud Container Registry como destino para las compilaciones locales. La imagen de origen se crea en el mismo espacio de nombres que la imagen de compilación.
Puede ignorar determinados patrones de archivo desde dentro del código fuente utilizando el archivo .ceignore, que se comporta de forma similar a un archivo .gitignore. Por ejemplo, las entradas de un archivo .ceignore para una aplicación node.js pueden incluir node_modules y .npm. Para obtener más patrones de archivo de ejemplo que ignorar, consulte el repositorioGitHub.gitignore.
La creación de una configuración de compilación no crea una imagen, sino que crea la configuración para crear una imagen. Luego debe ejecutar una compilación que haga referencia a la configuración de compilación para crear una imagen. La configuración de compilación no se valida ni se utiliza para crear una imagen hasta que se ejecuta la compilación. La configuración de compilación permite varias compilaciones posteriores de una imagen, por ejemplo cuando se aplican cambios en el repositorio de origen.
Para crear una configuración de compilación que extraiga el código de un directorio local con la CLI, utilice el mandato build create y especifique build-type como local. Para ver una lista
completa de opciones, consulte el mandato ibmcloud ce build create.
Con el mandato build create, puede hacer que Code Engine cree la imagen desde el origen y almacene la imagen en IBM Cloud Container Registry. Para este caso de acceso automático, no es necesario que especifique
un secreto de registro o la ubicación del registro de imágenes. O bien, puede especificar la ubicación para la salida de imagen de compilación y proporcionar un secreto de registro para que Code Engine pueda acceder y enviar el resultado de
compilación al registro.
Creación de una configuración de compilación con la CLI (con código fuente local y acceso automático al registro)
En este caso de ejemplo, Code Engine compila una imagen a partir del código fuente local y la carga automáticamente en IBM Cloud Container Registry. Consulte Configuración de autorizaciones para registros de imágenes para obtener más información sobre cómo establecer los permisos necesarios para que Code Engine acceda automáticamente a estas imágenes en Container Registry.
Antes de empezar
Cree una configuración de compilación para compilar una imagen a partir del código fuente en la estación de trabajo local y deje que Code Engine almacene automáticamente la imagen y acceda a ella. Cuando especifica local como valor
de -build-type, solo puede definir IBM Cloud Container Registry como destino para la salida de la compilación local. En este ejemplo, el mandato utiliza la estrategia dockerfile predeterminada y el tamaño de compilación
de medium predeterminado. Al no especificar la ubicación del registro de imágenes o un secreto de registro, Code Engine envía la salida de compilación a IBM Cloud Container Registry con acceso automático.
ibmcloud ce build create --name build-local-dockerfile --build-type local
Después de crear la configuración de compilación, debe ejecutar la compilación para crear el archivo de imagen. Después de crear el archivo de imagen, puede desplegar una app o ejecutar un trabajo con el archivo de imagen recién creado.
Creación de una configuración de compilación con la CLI (con código fuente local y acceso proporcionado por el usuario al registro)
En este caso de ejemplo, Code Engine compila una imagen a partir del código fuente local y, a continuación, la carga en el registro de contenedor con el acceso de registro que proporciona el usuario.
Antes de empezar
- Configure su entorno de CLI de Code Engine.
- Cree y trabaje con un proyecto.
- Cree un secreto de registro para que pueda guardar la imagen.
Cree una configuración de compilación para crear una imagen desde el origen en la estación de trabajo local y especifique la ubicación del registro de imágenes para la salida de compilación con un secreto de registro. Con el mandato build create,
cuando especifica local como el valor de --build-type, solo puede definir IBM Cloud Container Registry como destino para la salida de la compilación local. Especifique la opción --image para proporcionar
la ubicación del registro de imágenes y especifique la opción --registry-secret para acceder al registro. En este ejemplo, el mandato utiliza la estrategia dockerfile predeterminada y el tamaño de compilación de medium predeterminado.
ibmcloud ce build create --name build-local-dockerfile --build-type local --image us.icr.io/mynamespace/codeengine-build --registry-secret myregistry
Después de crear la configuración de compilación, debe ejecutar la compilación para crear el archivo de imagen. Después de crear el archivo de imagen, puede desplegar una app o ejecutar un trabajo con el archivo de imagen recién creado.