IBM Cloud Docs
Ejecución de una configuración de compilación

Ejecución de una configuración de compilación

Después de crear una configuración de compilación, puede enviar una ejecución basada en dicha configuración de compilación. Ejecute la compilación desde la consola o con la CLI.

Code Engine tiene cuotas para compilaciones y ejecuciones de compilaciones dentro de un proyecto. Para obtener más información sobre los límites de Code Engine, consulte Límites y cuotas de Code Engine.

Las ejecuciones de compilación que se completan se eliminan automáticamente. Cuando la ejecución de compilación se basa en la configuración de compilación, esta ejecución de compilación se elimina después de tres horas si la ejecución de compilación se realiza correctamente. Si la ejecución de compilación no tiene éxito, esta ejecución de compilación se elimina después de una semana.

Ejecución de una compilación desde la consola

  1. Vaya al panel de control de Code Engine.
  2. Seleccione el proyecto en el que ha creado la compilación.
  3. En la página del proyecto, pulse Compilaciones de imágenes.
  4. En la pestaña Compilación de imagen, seleccione el nombre de la compilación de imagen con la que desea trabajar.
  5. En la sección Configuración, puede revisar la configuración de la estructura y cambiar los valores, si es necesario.
  6. Verifique cualquier información adicional, como por ejemplo la Imagen de salida para esta ejecución de compilación, o sobrescriba el valor Tiempo de espera.
  7. Envíe la ejecución de la compilación pulsando Enviar compilación.

Supervise el progreso de la compilación en la sección Ejecuciones de compilación.

Ejecución de una compilación con la CLI para el código fuente de un repositorio (no local)

Para enviar una ejecución de compilación desde una configuración de compilación con la CLI, utilice el mandato buildrun submit. Este mandato requiere el nombre de una configuración de compilación. Se pueden especificar otros argumentos opcionales. Para ver una lista completa de opciones, consulte el mandato ibmcloud ce buildrun submit.

El ejemplo siguiente ejecuta una compilación denominada helloworld-build-run y utiliza la compilación helloworld-build.

ibmcloud ce buildrun submit --build helloworld-build --name helloworld-build-run

Salida de ejemplo

Submitting build run 'helloworld-build-run'...
Run 'ibmcloud ce buildrun get -n helloworld-build-run' to check the build run status.
OK

En la tabla siguiente se resumen las opciones que se utilizan con el mandato buildrun submit en este ejemplo. Para obtener más información sobre el mandato y sus opciones, consulte el mandato ibmcloud ce buildrun submit.

Descripción del mandato
Opción Descripción
--build El nombre de la configuración de compilación que se va a utilizar. Este valor es obligatorio.
--name El nombre de la ejecución de compilación. Utilice un nombre que sea exclusivo dentro del proyecto.
-El nombre debe empezar y terminar con un carácter alfanumérico en minúsculas.
-El nombre debe tener 63 caracteres o menos y puede contener caracteres alfanuméricos en minúsculas y guiones (-).

Comienzan las ejecuciones de la compilación. Supervise el progreso con el mandato ibmcloud ce buildrun get.

Por ejemplo, para comprobar el estado de la ejecución del ejemplo anterior,

ibmcloud ce buildrun get --name helloworld-build-run

Salida de ejemplo

Getting build run 'helloworld-build-run'...
[...]
OK

Name:          helloworld-build-run
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           21m
Created:       2021-03-14T14:50:13-05:00

Summary:  Succeeded
Status:   Succeeded
Reason:   Succeeded

Para obtener más información sobre las compilaciones, consulte las sugerencias sobre resolución de problemas.

Ejecución de una compilación con la CLI para el código fuente de un directorio local (local)

Para enviar una ejecución de compilación desde una configuración de compilación con la CLI que extraiga el código fuente de un directorio local, utilice el mandato buildrun submit. Este mandato requiere el nombre de una configuración de compilación y la vía de acceso al código fuente local. Se pueden especificar otros argumentos opcionales. Para ver una lista completa de opciones, consulte el mandato ibmcloud ce buildrun submit.

El siguiente escenario clona las muestras para un repositorio IBM Cloud Code Engine GitHub en un directorio CodeEngineLocalSample en su estación de trabajo local.

  1. Clonar las muestras para IBM Cloud Code Engine GitHub repo en un subdirectorio creado en su estación de trabajo local, como el subdirectorio CodeEngineLocalSamples. Desde este directorio, ejecute el comando git clone ; por ejemplo,

    git clone https://github.com/IBM/CodeEngine
    
  2. Vaya al directorio donde está el código fuente en la estación de trabajo. Por ejemplo, vaya al subdirectorio CodeEngine donde residen los ejemplos de Code Engine.

  3. Desde el directorio donde reside el código fuente, envíe la ejecución de compilación. El ejemplo siguiente ejecuta una compilación denominada buildrun-local-dockerfile y utiliza la configuración de compilación build-local-dockerfile. La opción --source especifica la vía de acceso al origen en la estación de trabajo local para el ejemplo de helloworld.

    ibmcloud ce buildrun submit --name buildrun-local-dockerfile --build build-local-dockerfile --source ./helloworld
    

    Salida de ejemplo

    Getting build 'build-local-dockerfile'
    Packaging files to upload from source path './helloworld' ...
    Submitting build run 'buildrun-local-dockerfile'...
    Run 'ibmcloud ce buildrun get -n buildrun-local-dockerfile' to check the build run status.
    OK
    
  4. Supervise el progreso de la ejecución de compilación utilizando el mandato ibmcloud ce buildrun get. Por ejemplo, para comprobar el estado de la ejecución del ejemplo anterior,

    ibmcloud ce buildrun get --name helloworld-build-run
    

    Salida de ejemplo

    Getting build run 'buildrun-local-dockerfile'...
    Run 'C:\Program Files\IBM\Cloud\bin\ibmcloud.exe ce buildrun events -n buildrun-local-dockerfile' to get the system events of the build run.
    Run 'C:\Program Files\IBM\Cloud\bin\ibmcloud.exe ce buildrun logs -f -n buildrun-local-dockerfile' to follow the logs of the build run.
    OK
    
    Name:          buildrun-local-dockerfile
    ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
    Project Name:  myproject
    Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
    Age:           40s
    Created:       2022-01-19T12:22:33-05:00
    
    Summary:       Succeeded
    Status:        Succeeded
    Reason:        All Steps have completed executing
    Source:
      Source Image Digest:  sha256:07159930b5abcf94e1a7451ea18490d4ad1162a77c2b987da5b7493fa1f1e49d
    Image Digest:  sha256:04c7be7db438a41040ea24d646314f1c847c191d88fffdbea6f483fc443c2bbe
    
    Build Name:    build-local-dockerfile
    Source Image:  us.icr.io/mynamespace/codeengine-build-source
    Image:         us.icr.io/mynamespace/codeengine-build
    Timeout:       10m0s
    

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. Una vez completada la ejecución de compilación, puede ver la imagen compilada, como por ejemplo codeengine-build, en la instancia de IBM Cloud Container Registry. También puede ver una imagen de origen con un -source agregado al nombre de su compilación, como codeengine-build-source. Puede suprimir esta imagen de origen sin que esta acción tenga ningún impacto.

Para obtener más información sobre las compilaciones, consulte las sugerencias sobre resolución de problemas.