Personalizar pilas y compilaciones

Kf usa paquetes de compilación para convertir el código fuente de una aplicación en una imagen ejecutable. Cloud Native Buildpacks usa la API Buildpack v3 más reciente y empresas como VMware y Heroku están añadiendo activamente la compatibilidad con la versión 3 a los buildpacks.

Kf admite buildpacks que cumplen las versiones V2 y V3 de la especificación de la API Buildpack.

Comparación entre paquetes de compilaciones V2 y V3

	Paquetes de compilación V2	Paquetes de compilación V3
Nombres alternativos	Buildpacks de Cloud Foundry	Cloud Native Buildpacks (CNB) e imágenes de compilación
Estado	Se está sustituyendo	Actual
Propiedad	Cloud Foundry	Buildpacks.io
Pila	Compartido por el compilador y el tiempo de ejecución	Opcionalmente, puede ser diferente para el compilador y el tiempo de ejecución.
Desarrollo local	No es posible.	Sí, con la CLI de `pack`
Compilaciones personalizadas	Disponible en el tiempo de ejecución	Debe estar integrado en el compilador

Ciclo de vida de los buildpacks

Paso	Cloud Foundry	Kf con paquetes de compilación V2	Kf con paquetes de compilación V3
Ubicación de origen	Servicio BITS	Registro de contenedor	Registro de contenedor
Ubicación del paquete de compilación	BOSH/HTTP	HTTP	Registro de contenedor
Ubicación de la pila	BOSH	Registro de contenedor	Registro de contenedor
Resultado	Droplet (binario de aplicación sin pila)	Imagen (gota en una pila)	Imagen
Tiempo de ejecución	Gota pegada en la parte superior de la pila y en ejecución	Imagen producida por Run	Imagen producida por Run

Kf siempre genera una imagen completa y ejecutable como resultado de su proceso de compilación. Por otro lado, Cloud Foundry genera partes de una imagen ejecutable durante la compilación y el resto se añade durante el tiempo de ejecución.

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

Las imágenes se pueden exportar, ejecutar de forma local e inspeccionar de forma estática
Mejor seguridad y auditoría con herramientas como la autorización binaria
Los despliegues de aplicaciones son reproducibles

Kf y paquetes de compilación

Kf almacena su lista global de buildpacks y stacks en el config-defaults ConfigMap del espacio de nombres kf. 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:

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 que debes consultar:

Buildpacks V2 contiene una lista de paquetes de compilación compatibles con V2 en el orden en que se ejecutarán.
Stacks V2 indica las pilas que se pueden elegir para activar una compilación de buildpack de V2.
Stacks V3 indica 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

Como las imágenes de compilación de la versión 3 ya tienen sus buildpacks 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
  ...

Personalizar paquetes de compilación V3

Puedes personalizar los buildpacks que están disponibles para tus desarrolladores creando tu propia imagen de compilador con los buildpacks a los que deberían tener acceso. También puedes usar imágenes de compilación publicadas por otros autores.

Usar una imagen de compilación de terceros

Puedes consultar una lista de pilas de CNB publicadas en la CLI de paquetes de compilación pack. En el momento de escribir este artículo, pack suggest-stacks genera 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

Para modificar Kf de forma que use la pila publicada por Heroku, edita el config-defaults ConfigMap en el espacio de nombres kf. Añade una entrada a la clave spaceStacksV3 como la siguiente:

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

A continuación, 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

Crear una imagen de creador

La CLI de paquetes de compilaciónpack se usa para crear tu propia imagen de compilador. Puedes seguir la documentación de packTrabajar con compiladores usando create-builder para crear tu propia imagen de compilador. Una vez creado, envíalo a un registro de contenedores y añádelo al config-defaults ConfigMap.

Definir un stack predeterminado

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

Puedes forzar a Kf a usar una pila V3 en lugar de una V2 configurando el campo spaceDefaultToV3Stack en el ConfigMap config-defaults del espacio de nombres kf como "true":

kubectl edit configmap config-defaults -n kf
spaceDefaultToV3Stack: "true"

Esta opción también se puede modificar en cada espacio cambiando el valor del campo spec.buildConfig.defaultToV3Stack a true o false. Si no se define, se usará el valor de config-defaults ConfigMap.

Valor de `config-defaults` para `spaceDefaultToV3Stack`	Espacio `spec.buildConfig.defaultToV3Stack`	Pila predeterminada
unset	unset	V2
`"false"`	unset	V2
`"true"`	unset	V3
any	`false`	V2
any	`true`	V3

Personalizar pilas y compilaciones Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.