I buildpack vengono utilizzati da Kf per trasformare il codice sorgente di un'applicazione in un'immagine eseguibile. I Buildpack cloud-native utilizzano la più recente API Buildpack v3 e aziende come VMware ed Heroku stanno aggiungendo attivamente il supporto v3 ai buildpack esistenti.
Kf supporta i buildpack conformi sia alla v2 sia alla v3 della specifica dell'API Buildpack.
Confronto tra i buildpack V2 e V3
| Buildpack V2 | Buildpack V3 | |
|---|---|---|
| Nomi alternativi | Buildpack Cloud Foundry | Buildpacks (CNB) Cloud Native, immagini Builder |
| Stato | In fase di sostituzione | Attuale |
| Proprietà | Cloud Foundry | Buildpacks.io |
| Impilare | Condivisi da Builder e runtime | Facoltativamente diverso per il generatore e il runtime |
| Sviluppo locale | Impossibile | Sì, con l'interfaccia a riga di comando pack |
| Buildpack personalizzati | Disponibile in fase di esecuzione | Deve essere integrato nel generatore |
Ciclo di vita del Buildpack
| Passaggio | Cloud Foundry | Kf con Buildpacks V2 | Kf con Buildpacks V3 |
|---|---|---|---|
| Posizione di origine | Servizio BITS | Container Registry | Container Registry |
| Località del buildpack | BOSH/HTTP | HTTP | Container Registry |
| Posizione dello stack | BOSH | Container Registry | Container Registry |
| Risultato | Droplet (file binario dell'app senza stack) | Immagine (Goccia in una pila) | Immagine |
| Runtime | Goccia incollata sulla parte superiore della pila e in esecuzione | Esegui l'immagine prodotta | Esegui l'immagine prodotta |
Kf sempre produce un'immagine completa ed eseguibile come risultato del processo di compilazione. Cloud Foundry, invece, produce parti di un'immagine eseguibile in fase di compilazione e il resto viene aggiunto in fase di runtime.
Kf ha scelto di seguire il modello di produzione di un'immagine completa per i seguenti motivi:
- Le immagini possono essere esportate, eseguite localmente e ispezionate in modo statico
- Maggiore sicurezza e controllo con strumenti come l'autorizzazione binaria
- I deployment delle app sono riproducibili
Kf e Buildpack
Kf archivia il proprio elenco globale di buildpack e stack nel ConfigMap config-defaults dello spazio dei nomi kf.
Ogni spazio riflette questi buildpack nel relativo campo di stato.
Per uno spazio denominato buildpack-docs, puoi eseguire il seguente comando per visualizzare la configurazione completa dello spazio:
$ 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
Nella sezione Build Config sono presenti tre campi da esaminare:
- Buildpacks V2 contiene un elenco di buildpack compatibili con V2 nell'ordine in cui verranno eseguiti
- Stack V2 indica gli stack che è possibile scegliere per attivare una build buildpack V2
- Stack V3 indica gli stack che è possibile scegliere per attivare una build buildpack V3
Puoi anche elencare le serie 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
Poiché le immagini build V3 hanno già i buildpack integrati, devi utilizzare kf buildpacks per ottenere l'elenco:
$ 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
...
Personalizzazione dei buildpack V3
Puoi personalizzare i buildpack disponibili per gli sviluppatori creando la tua immagine del builder con esattamente i buildpack a cui dovrebbero avere accesso. Puoi anche utilizzare immagini del generatore pubblicate da altri autori.
Utilizzare un'immagine del generatore di terze parti
Un elenco degli stack CNB pubblicati è disponibile nell'interfaccia a riga di comando Buildpack pack. Al momento della stesura del presente documento, pack suggest-stacks restituisce:
$ 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
Per modificare Kf e utilizzare lo stack pubblicato da Heroku, modifica config-defaults ConfigMap nello spazio dei nomi kf.
Aggiungi una voce alla chiave spaceStacksV3 come segue:
$ kubectl edit configmap config-defaults -n kf
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
Quindi, esegui di nuovo 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
Creare un'immagine del tuo creator
L'interfaccia a riga di comando Buildpack pack viene utilizzata per creare la tua immagine del builder. Per creare la tua immagine del builder, puoi seguire la documentazione di pack Collaborare con i builder utilizzando create-builder. Una volta creato, esegui il push in un Container Registry e utilizzalo per aggiungerlo al ConfigMap config-defaults.
Impostare una serie predefinita
Alle app verrà assegnato uno stack predefinito, se non è specificato nel file manifest. Lo stack predefinito è il primo nell'elenco di stack V2 o V3. Se non viene sostituito, viene scelto uno stack V2 per garantire la compatibilità con Cloud Foundry.
È possibile forzare Kf a utilizzare uno stack V3 anziché V2 impostando il parametro
Campo spaceDefaultToV3Stack nel ConfigMap config-defaults in kf
Spazio dei nomi da "true":
$ kubectl edit configmap config-defaults -n kf
spaceDefaultToV3Stack: "true"
Questa opzione può essere modificata anche in base allo spazio impostando il campo spec.buildConfig.defaultToV3Stack su true o false. Se non è impostato, viene utilizzato il valore del ConfigMap config-defaults.
Valore config-defaults per spaceDefaultToV3Stack |
spec.buildConfig.defaultToV3Stack dello spazio |
Pila predefinita |
|---|---|---|
| unset | non impostato | V2 |
"false" |
non impostato | V2 |
"true" |
unset | V3 |
| any | false |
V2 |
| qualsiasi | true |
V3 |