Os pacotes de criação são usados pelo Kf para transformar o código-fonte de um aplicativo em uma imagem executável. O Cloud Native Buildpacks usa a versão mais recente da API Buildpack v3, e as empresas, incluindo VMware e Heroku, estão adicionando ativamente o suporte da v3 aos pacotes de criação atuais.
O Kf é compatível com Buildpacks em conformidade com V2 e V3 da especificação da API Buildpack.
Comparação entre pacotes de criação V2 e V3
| Buildpacks V2 | Buildpacks V3 | |
|---|---|---|
| Nomes alternativos | Cloud Foundry Buildpacks | Cloud Native Buildpacks (CNB), imagens do Builder |
| Status | Sendo substituído | Atual |
| Propriedade | Cloud Foundry | Buildpacks.io (em inglês) |
| Stack | Compartilhado por builder e ambiente de execução | Opcionalmente, para builder e ambiente de execução |
| Desenvolvimento local | Não é possível | Sim, com a CLI pack |
| Pacotes de criação personalizados | Disponível no ambiente de execução | Precisa ser incorporado ao builder. |
Ciclo de vida do buildpack
| Etapa | Cloud Foundry | Kf com Buildpacks V2 | Kf com Buildpacks V3 |
|---|---|---|---|
| Local de origem | Serviço do BITS | Container Registry | Container Registry |
| Local do Buildpack | BOSH/HTTP | HTTP | Container Registry |
| Local da pilha | BOSH | Container Registry | Container Registry |
| Result | Droplet (binário de aplicativo sem pilha) | Imagem (Droplet em uma pilha) | Image |
| Runtime | Droplet colado na pilha e executado | Executar imagem do produto | Executar imagem do produto |
O Kf sempre produz uma imagem completa e executável como resultado do processo de compilação. O Cloud Foundry, por outro lado, produz partes de uma imagem executável no tempo de compilação e o restante é adicionado no ambiente de execução.
O Kf optou por seguir o modelo de sempre produzir uma imagem completa pelos seguintes motivos:
- As imagens podem ser exportadas, executadas localmente e inspecionadas estaticamente
- Mais segurança e auditoria com ferramentas como autorização binária
- As implantações de aplicativos são reproduzíveis
Kf e Buildpacks
O Kf armazena a lista global de pacotes de criação e pilhas no ConfigMap config-defaults no namespace kf.
Cada espaço reflete esses pacotes de criação no campo de status.
Para um espaço chamado buildpack-docs, você pode executar o seguinte para ver a configuração completa do espaço:
$ 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
Na seção Build Config, há três campos a serem observados:
- Os Buildpacks V2 contêm uma lista de pacotes de criação compatíveis com V2 na ordem em que serão executados
- Stacks V2 indicam as pilhas que podem ser escolhidas para acionar um build do pacote de criação V2
- Stacks V3 indica as pilhas que podem ser escolhidas para acionar um build do pacote de criação V3.
Também é possível listar as pilhas com 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 as imagens de build V3 já têm pacotes de criação integrados, use kf buildpacks para ver a 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
...
Como personalizar Buildpacks V3
Você pode personalizar os pacotes de criação disponíveis para seus desenvolvedores criando sua própria imagem do builder com exatamente os pacotes a que eles têm acesso. Você também pode usar imagens do builder publicadas por outros autores.
Usar uma imagem do builder de terceiros
Uma lista de pilhas CNB publicadas está disponível na CLI do Buildpack pack. No momento em que este artigo foi escrito, o pack suggest-stacks gerou:
$ 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 o Kf para usar a pilha publicada pelo Heroku, edite o ConfigMap config-defaults no namespace kf.
Adicione uma entrada à chave spaceStacksV3 como esta:
$ 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
Em seguida, execute stacks novamente:
$ 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
Criar sua própria imagem do builder
A CLI do Buildpack pack é usada para criar sua própria imagem do builder. Você pode seguir a documentação Como trabalhar com builders usando create-builder de pack para criar sua própria imagem de builder. Uma vez criada, envie-a para um registro de contêiner e use-a para o ConfigMap config-defaults.
Como configurar uma pilha padrão
Os aplicativos receberão uma pilha padrão, se não houver uma no manifesto. A pilha padrão é a primeira na lista de pilhas V2 ou V3. A menos que seja modificada, uma pilha V2 é escolhida para compatibilidade com o Cloud Foundry.
Você pode forçar o Kf a usar uma pilha V3 em vez de uma V2 definindo o campo spaceDefaultToV3Stack no ConfigMap config-defaults no namespace kf como "true":
$ kubectl edit configmap config-defaults -n kf
spaceDefaultToV3Stack: "true"
Essa opção também pode ser modificada pelo espaço, alterando a configuração do campo spec.buildConfig.defaultToV3Stack para true ou false. Se não for definido, o valor do ConfigMap config-defaults será usado.
Valor config-defaults para spaceDefaultToV3Stack |
spec.buildConfig.defaultToV3Stack do espaço |
Pilha padrão |
|---|---|---|
| unset | unset | V2 |
"false" |
unset | V2 |
"true" |
unset | V3 |
| qualquer um | false |
V2 |
| qualquer um | true |
V3 |