Personalizar pilas y paquetes de compilación

Kf usa los paquetes de compilación para convertir el código fuente de una aplicación en una imagen ejecutable. Los paquetes de compilación nativos de la nube usan la última versión de la API de Buildpack v3. Las empresas están agregando compatibilidad de forma activa con v3 a los paquetes de compilación existentes.

Kf es compatible con los paquetes de compilación que se ajustan a las V2 y V3 de la especificación de la API de Buildpack.

Compara los paquetes de compilación V2 y V3

Paquetes de compilación V2 Paquetes de compilación V3
Nombres alternativos Paquetes de compilación de Cloud Foundry Paquetes de compilación nativos de la nube (CNB), imágenes de compiladores
Estado Se reemplazará Actual
Propiedad Cloud Foundry Buildpacks.io
Pila Compartido por el compilador y el entorno de ejecución Puede ser diferente para el compilador y el entorno de ejecución
Desarrollo local No es posible Sí, con la CLI de pack
Paquetes de compilación personalizados Disponible en el entorno de ejecución Deben estar integrados en el compilador

Ciclo de vida de paquete de compilación

Paso Cloud Foundry Kf con paquetes de compilación V2 Kf con paquetes de compilación V3
Ubicación de la fuente Servicio de BITS Container Registry Container Registry
Ubicación del paquete de compilación BOSH/HTTP HTTP Container Registry
Ubicación de la pila BOSH Container Registry Container Registry
Resultado Droplet (objeto binario de la app sin pila) Imagen (droplet en una pila) Imagen
Entorno de ejecución Droplet pegada sobre la pila y en ejecución Ejecuta la imagen producida Ejecuta la imagen producida

Kf siempre produce una imagen ejecutable como resultado de su proceso de compilación. Por otro lado, Cloud Foundry produce partes de una imagen ejecutable durante el tiempo de compilación y el resto se agrega en el tiempo de ejecución.

Kf eligió seguir el modelo de producir siempre una imagen completa por los siguientes motivos:

  • Las imágenes se pueden exportar, ejecutar de forma local y, también, inspeccionarse de forma estática.
  • Mayor seguridad y auditoría con herramientas como la autorización binaria.
  • Las implementaciones de la app son reproducibles.

Kf y paquetes de compilación

Kf almacena su lista global de paquetes de compilación y pilas en el ConfigMap config-defaults en el espacio de nombres kf. La modificación de las propiedades de pilas y paquetes de compilación debe realizarse en el recurso personalizado kfsystem; el operador Kf actualiza automáticamente el ConfigMap config-defaults según los valores establecidos en kfsystem.

Cada espacio refleja estos paquetes de compilación en su campo de estado. En el caso de un espacio llamado buildpack-docs, puedes ejecutar el siguiente comando para ver la configuración completa del espacio:

kf space buildpack-docs
Getting Space buildpack-docs
API Version:  kf.dev/v1alpha1
Kind:         Space
Metadata:
  Creation Timestamp:  2020-02-14T15:09:52Z
  Name:                buildpack-docs
  Self Link:           /apis/kf.dev/v1alpha1/spaces/buildpack-docs
  UID:                 0cf1e196-4f3c-11ea-91a4-42010a80008d
Status:
  Build Config:
    Buildpacks V2:
    - Name:      staticfile_buildpack
      URL:       https://github.com/cloudfoundry/staticfile-buildpack
      Disabled:  false
    - Name:      java_buildpack
      URL:       https://github.com/cloudfoundry/java-buildpack
      Disabled:  false
    Stacks V2:
    - Image:  cloudfoundry/cflinuxfs3
      Name:   cflinuxfs3
    Stacks V3:
    - Build Image:  cloudfoundry/cnb:cflinuxfs3
      Description:  A large Cloud Foundry stack based on Ubuntu 18.04
      Name:         org.cloudfoundry.stacks.cflinuxfs3
      Run Image:    cloudfoundry/run:full-cnb

En la sección Build Config, hay tres campos a los que se debe prestar atención:

  • Los paquetes de compilación V2 contienen una lista de paquetes de compilación compatibles con V2 en el orden en que se ejecutarán.
  • Las pilas V2 indican las pilas que se pueden elegir para activar una compilación de paquetes de compilación V2
  • Las pilas V3 indican las pilas que se pueden elegir para activar una compilación de paquetes de compilación V3.

También puedes enumerar las pilas con kf stacks:

kf stacks
Getting stacks in Space: buildpack-docs
Version  Name                                Build Image                  Run Image                  Description
V2       cflinuxfs3                          cloudfoundry/cflinuxfs3      cloudfoundry/cflinuxfs3
V3       org.cloudfoundry.stacks.cflinuxfs3  cloudfoundry/cnb:cflinuxfs3  cloudfoundry/run:full-cnb  A large Cloud Foundry stack based on Ubuntu 18.04

Debido a que las imágenes de compilación de V3 ya tienen sus paquetes de compilación integrados, debes usar kf buildpacks para obtener la lista:

kf buildpacks
Getting buildpacks in Space: buildpack-docs
Buildpacks for V2 stacks:
  Name                   Position  URL
  staticfile_buildpack   0         https://github.com/cloudfoundry/staticfile-buildpack
  java_buildpack         1         https://github.com/cloudfoundry/java-buildpack
V3 Stack: org.cloudfoundry.stacks.cflinuxfs3:
  Name                                        Position  Version     Latest
  org.cloudfoundry.jdbc                       0         v1.0.179    true
  org.cloudfoundry.jmx                        1         v1.0.180    true
  org.cloudfoundry.go                         2         v0.0.2      true
  org.cloudfoundry.tomcat                     3         v1.1.102    true
  org.cloudfoundry.distzip                    4         v1.0.171    true
  org.cloudfoundry.springboot                 5         v1.1.2      true
  ...

Personaliza los paquetes de compilación V3

Puedes personalizar los paquetes de compilación que están disponibles para tus desarrolladores si creas tu propia imagen de compilador con exactamente los paquetes de compilación a los que deben tener acceso. También puedes utilizar imágenes de compilador publicadas por otros autores.

Usa una imagen de compilador de terceros

Hay una lista de las pilas de CNB publicadas en la CLI de Buildpack pack. A partir de esta escritura, pack suggest-stacks muestra lo siguiente:

pack suggest-stacks
Stacks maintained by the community:
    Stack ID: heroku-18
    Description: The official Heroku stack based on Ubuntu 18.04
    Maintainer: Heroku
    Build Image: heroku/pack:18-build
    Run Image: heroku/pack:18
    Stack ID: io.buildpacks.stacks.bionic
    Description: A minimal Cloud Foundry stack based on Ubuntu 18.04
    Maintainer: Cloud Foundry
    Build Image: cloudfoundry/build:base-cnb
    Run Image: cloudfoundry/run:base-cnb
    Stack ID: org.cloudfoundry.stacks.cflinuxfs3
    Description: A large Cloud Foundry stack based on Ubuntu 18.04
    Maintainer: Cloud Foundry
    Build Image: cloudfoundry/build:full-cnb
    Run Image: cloudfoundry/run:full-cnb
    Stack ID: org.cloudfoundry.stacks.tiny
    Description: A tiny Cloud Foundry stack based on Ubuntu 18.04, similar to distroless
    Maintainer: Cloud Foundry
    Build Image: cloudfoundry/build:tiny-cnb
    Run Image: cloudfoundry/run:tiny-cnb

Si deseas modificar Kf para que use la pila publicada por Heroku, edita el recurso personalizado kfsystem, que actualiza de forma automática el ConfigMap config-defaults en el espacio de nombres kf. Agrega una entrada a la clave spaceStacksV3 como se muestra a continuación:

kubectl edit kfsystem kfsystem
spaceStacksV3: |
  - name: org.cloudfoundry.stacks.cflinuxfs3
    description: A large Cloud Foundry stack based on Ubuntu 18.04
    buildImage: cloudfoundry/cnb:cflinuxfs3
    runImage: cloudfoundry/run:full-cnb
  - name: heroku-18
    description: The official Heroku stack based on Ubuntu 18.04
    buildImage: heroku/pack:18-build
    runImage: heroku/pack:18

Luego, vuelve a ejecutar stacks:

kf stacks
Getting stacks in Space: buildpack-docs
Version  Name                                Build Image                  Run Image                  Description
V2       cflinuxfs3                          cloudfoundry/cflinuxfs3      cloudfoundry/cflinuxfs3
V3       org.cloudfoundry.stacks.cflinuxfs3  cloudfoundry/cnb:cflinuxfs3  cloudfoundry/run:full-cnb  A large Cloud Foundry stack based on Ubuntu 18.04
V3       heroku-18                           heroku/pack:18-build         heroku/pack:18             The official Heroku stack based on Ubuntu 18.04

Crea tu propia imagen de compilador

La CLI de paquetes de compilación pack se usa para crear tu propia imagen de compilador. Puedes seguir la documentación Trabaja con compiladores que usan create-builder de pack para crear tu propia imagen de compilador. Después de crearla, envíala a un registro de contenedores y agrégala al recurso personalizado kfsystem.

Configura una pila predeterminada

A las apps se les asignará una pila predeterminada si no se proporciona una en su manifiesto. La pila predeterminada es la primera en la lista de pilas V2 o V3. A menos que se anule, se elige una pila V2 para brindar compatibilidad con Cloud Foundry.

Para hacer que Kf use una pila de V3 en lugar de V2, establece el campo spaceDefaultToV3Stack en el recurso personalizado kfsystem en "true" (kfsystem actualiza automáticamente la spaceDefaultToV3Stack correspondiente en el ConfigMap config-defaults):

kubectl edit kfsystem kfsystem
spaceDefaultToV3Stack: "true"

Esta opción también se puede modificar por espacio. Para ello, cambia el campo spec.buildConfig.defaultToV3Stack a true o false. Si no se configura, se usa el valor del ConfigMap config-defaults.

Valor de config-defaults para spaceDefaultToV3Stack spec.buildConfig.defaultToV3Stack del espacio Pila predeterminada
unset unset V2
"false" unset V2
"true" unset V3
cualquiera false V2
cualquiera true V3

¿Qué sigue?