Menyesuaikan Stack dan Buildpacks

Buildpack digunakan oleh Kf untuk mengubah kode sumber aplikasi menjadi image yang dapat dieksekusi. Cloud Native Buildpacks menggunakan Buildpack API v3 terbaru dan perusahaan termasuk VMware dan Heroku secara aktif menambahkan dukungan v3 ke buildpack yang ada.

Kf mendukung Buildpack yang sesuai dengan spesifikasi Buildpack API V2 dan V3.

Perbandingan antara buildpack V2 dan V3

Buildpack V2 Buildpack V3
Nama alternatif Buildpack Cloud Foundry Buildpack Berbasis Cloud (CNB), Image Builder
Status Sedang Diganti Saat ini
Kepemilikan Cloud Foundry Buildpacks.io
Stack Dibagikan oleh builder dan runtime Opsional berbeda untuk builder dan runtime
Pengembangan lokal Tidak memungkinkan Ya, dengan pack CLI
Buildpack kustom Tersedia saat runtime Harus di-build ke dalam builder

Siklus proses buildpack

Langkah Cloud Foundry Kf dengan Buildpack V2 Kf dengan Buildpack V3
Lokasi sumber Layanan BITS Container registry Container registry
Lokasi buildpack BOSH/HTTP HTTP Container registry
Lokasi stack BOSH Container registry Container registry
Hasil Droplet (Biner aplikasi tanpa stack) Gambar (Droplet di stack) Gambar
Runtime Tetesan dilem di atas tumpukan dan dijalankan Menjalankan gambar yang dihasilkan Menjalankan gambar yang dihasilkan

Kf selalu menghasilkan image lengkap yang dapat dieksekusi sebagai hasil dari proses build-nya. Di sisi lain, Cloud Foundry menghasilkan bagian dari image yang dapat dieksekusi pada waktu build dan sisanya ditambahkan saat runtime.

Kf memilih untuk mengikuti model yang selalu menghasilkan gambar lengkap karena alasan berikut:

  • Image dapat diekspor, dijalankan secara lokal, dan diperiksa secara statis
  • Keamanan dan audit yang lebih baik dengan alat seperti otorisasi biner
  • Deployment aplikasi dapat direproduksi

Kf dan Buildpack

Kf menyimpan daftar buildpack dan stack globalnya di ConfigMap config-defaults di Namespace kf. Setiap Ruang mencerminkan buildpack ini di kolom statusnya. Untuk Ruang bernama buildpack-docs, Anda dapat menjalankan perintah berikut untuk melihat konfigurasi Ruang lengkap:

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

Di bagian Build Config, ada tiga kolom yang perlu dilihat:

  • Buildpack V2 berisi daftar buildpack yang kompatibel dengan V2 dalam urutan yang akan dijalankan
  • Stacks V2 menunjukkan stack yang dapat dipilih untuk memicu build buildpack V2
  • Stacks V3 menunjukkan stack yang dapat dipilih untuk memicu build buildpack V3

Anda juga dapat mencantumkan stack dengan 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

Karena image build V3 sudah memiliki buildpack bawaan, Anda harus menggunakan kf buildpacks untuk mendapatkan daftarnya:

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
  ...

Menyesuaikan Buildpack V3

Anda dapat menyesuaikan buildpack yang tersedia untuk developer dengan membuat image builder Anda sendiri dengan buildpack yang harus mereka akses. Anda juga dapat menggunakan image builder yang dipublikasikan oleh penulis lain.

Menggunakan image builder pihak ketiga

Daftar stack CNB yang dipublikasikan tersedia dari Buildpack CLI pack. Saat penulisan ini, output pack suggest-stacks:

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

Untuk mengubah Kf agar menggunakan stack yang dipublikasikan oleh Heroku, edit ConfigMap config-defaults di Namespace kf. Tambahkan entri ke kunci spaceStacksV3 seperti berikut:

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

Kemudian, jalankan stacks lagi:

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

Membuat image builder Anda sendiri

Buildpack CLI pack digunakan untuk membuat image builder Anda sendiri. Anda dapat mengikuti dokumentasi Menggunakan builder menggunakan create-builder pack untuk membuat image builder Anda sendiri. Setelah dibuat, kirim ke container registry dan gunakan untuk menambahkannya ke ConfigMap config-defaults.

Menetapkan stack default

Aplikasi akan diberi stack default jika tidak disediakan dalam manifesnya. Stack default adalah yang pertama dalam daftar stack V2 atau V3. Kecuali jika diganti, stack V2 akan dipilih untuk kompatibilitas dengan Cloud Foundry.

Anda dapat memaksa Kf untuk menggunakan stack V3, bukan V2, dengan menetapkan kolom spaceDefaultToV3Stack di ConfigMap config-defaults di Namespace kf menjadi "true":

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

Opsi ini juga dapat diubah berdasarkan Ruang dengan mengubah setelan kolom spec.buildConfig.defaultToV3Stack menjadi true atau false. Jika tidak ditetapkan, nilai dari ConfigMap config-defaults akan digunakan.

Nilai config-defaults untuk spaceDefaultToV3Stack spec.buildConfig.defaultToV3Stack Ruang Stack default
unset unset V2
"false" unset V2
"true" unset V3
apa pun false V2
apa pun true V3