Konfigurasi Cluster

Kf menggunakan configmap Kubernetes bernama config-defaults di namespace kf untuk menyimpan setelan konfigurasi seluruh cluster. Dokumen ini menjelaskan struktur dan kolomnya.

Struktur configmap config-defaults

ConfigMap berisi tiga jenis key-value pair di kolom .data:

  • Kunci komentar yang diawali dengan _ berisi contoh, catatan, dan peringatan.
  • Kunci string berisi nilai teks biasa.
  • Kunci objek berisi nilai JSON atau YAML yang telah dienkode sebagai string.

Contoh:

_note: "This is some note"
stringKey: "This is a string key that's not encoded as JSON or YAML."
objectKey: |
  - "These keys contain nested YAML or JSON."
  - true
  - 123.45

Contoh bagian

Bagian contoh di bawah kunci _example berisi penjelasan untuk kolom dan contoh lainnya. Perubahan pada bagian ini tidak akan berpengaruh.

Registry penampung ruang

Properti spaceContainerRegistry adalah nilai teks biasa yang menentukan container registry default yang digunakan setiap ruang untuk menyimpan image yang di-build.

Contoh:

spaceContainerRegistry: gcr.io/my-project

Domain cluster ruang

Properti spaceClusterDomains adalah array YAML objek domain yang dienkode string.

Setiap ruang dalam cluster menambahkan semua item dalam array ke daftar domain yang dapat digunakan developer untuk mengikat aplikasi mereka.

Kolom
domain

string

Nama domain yang akan disediakan. Dapat berisi salah satu penggantian berikut:

  • $(SPACE_NAME) - Diganti di setiap ruang dengan nama ruang.
  • $(CLUSTER_INGRESS_IP) - Alamat IP gateway ingress cluster.
gatewayName

string

(Opsional)

Mengganti rute gateway Istio yang akan terikat. Secara default ditetapkan ke kf/external-gateway, tetapi gateway lain di namespace kf dapat digunakan.

Contoh:

spaceClusterDomains: |
  # Support canonical and vanity domains
  - domain: $(SPACE_NAME).prod.example.com
  - domain: $(SPACE_NAME).kf.us-east1.prod.example.com

  # Using a dynamic DNS resolver
  - domain: $(SPACE_NAME).$(CLUSTER_INGRESS_IP).nip.io

  # Creating an internal domain only visible within the cluster
  - domain: $(SPACE_NAME)-apps.internal
    gatewayName: kf/internal-gateway

Builder siklus proses Buildpack V2

Properti buildpacksV2LifecycleBuilder berisi versi biner builder Cloud Foundry yang digunakan untuk menjalankan build buildpack v2.

Nilainya adalah referensi Git. Untuk menggunakan versi tertentu, tambahkan simbol @ diikuti dengan SHA Git di bagian akhir.

Contoh:

buildpacksV2LifecycleBuilder: "code.cloudfoundry.org/buildpackapplifecycle/builder@GIT_SHA"

Peluncur siklus proses Buildpack V2

Properti buildpacksV2LifecycleLauncher berisi versi biner launcher Cloud Foundry yang di-build ke dalam setiap aplikasi buildpack V2.

Nilainya adalah referensi Git. Untuk menggunakan versi tertentu, tambahkan simbol @ diikuti dengan SHA Git di bagian akhir.

Contoh:

buildpacksV2LifecycleLauncher: "code.cloudfoundry.org/buildpackapplifecycle/launcher@GIT_SHA"

Daftar Buildpack V2

Properti spaceBuildpacksV2 adalah array YAML yang dienkode string yang menyimpan daftar buildpack default yang diurutkan dan digunakan untuk mem-build aplikasi yang kompatibel dengan proses buildpack V2.

Kolom
name

string

Nama pendek yang dapat digunakan developer untuk mereferensikan buildpack dalam manifes aplikasi mereka.
url

string

URL yang digunakan untuk mengambil buildpack.
disabled

boolean

Digunakan untuk mencegah buildpack ini dieksekusi.

Daftar Stacks V2

Properti spaceBuildpacksV2 adalah array YAML yang dienkode string yang menyimpan daftar stack yang diurutkan dan dapat digunakan dengan build yang kompatibel dengan Cloud Foundry.

Kolom
name

string

Nama singkat yang dapat digunakan developer untuk mereferensikan stack dalam manifes aplikasi mereka.
image

string

URL image container yang akan digunakan sebagai stack. Untuk mengetahui informasi selengkapnya, lihat https://kubernetes.io/docs/concepts/containers/images.

Daftar Stacks V3

Properti spaceStacksV3 adalah array YAML yang dienkode string yang menyimpan daftar stack yang diurutkan dan dapat digunakan dengan build Cloud Native Buildpack.

Kolom
name

string

Nama singkat yang dapat digunakan developer untuk mereferensikan stack dalam manifes aplikasi mereka.
description

string

Deskripsi singkat stack yang ditampilkan saat menjalankan kf stacks.
buildImage

string

URL image container yang akan digunakan sebagai builder. Untuk mengetahui informasi selengkapnya, lihat https://kubernetes.io/docs/concepts/containers/images.

runImage

string

URL image container yang akan digunakan sebagai dasar untuk semua aplikasi yang di-build dengan . Untuk mengetahui informasi selengkapnya, lihat https://kubernetes.io/docs/concepts/containers/images.

nodeSelector

map (key: string, value: string)

(Opsional)

NodeSelector yang digunakan untuk menunjukkan node tempat aplikasi yang dibuat dengan stack ini dapat berjalan.

Contoh:

spaceStacksV3: |
  - name: heroku-18
    description: The official Heroku stack based on Ubuntu 18.04
    buildImage: heroku/pack:18-build
    runImage: heroku/pack:18
    nodeSelector:
       kubernetes.io/os: windows

Setelan defaultnya adalah Stack V3

Properti spaceDefaultToV3Stack berisi nilai yang diapit tanda kutip true atau false yang menunjukkan apakah ruang harus menggunakan stack V3 jika pengguna tidak menentukannya.

Tombol fitur

Properti featureFlags berisi peta YAML yang dienkode string dari flag fitur yang dapat mengaktifkan dan menonaktifkan fitur Kf.

Nama tanda yang tidak didukung oleh Kf akan diabaikan.

Nama Flag Default Tujuan
disable_custom_builds false Menonaktifkan akses developer ke pipeline build Tekton arbitrer.
enable_dockerfile_builds true Mengizinkan developer mem-build kode sumber dari dockerfile.
enable_custom_buildpacks true Memungkinkan developer menentukan buildpack eksternal dalam aplikasi mereka.
enable_custom_stacks true Memungkinkan developer menentukan stack kustom dalam aplikasi mereka.

Contoh:

featureFlags: |
  disable_custom_builds: false
  enable_dockerfile_builds: true
  enable_some_feature: true