Configurazione cluster

Kf utilizza un configmap Kubernetes denominato config-defaults nello spazio dei nomi kf per memorizzare le impostazioni di configurazione a livello di cluster. Questo documento ne spiega la struttura e i campi.

Struttura della configmap config-defaults

Il file configmap contiene tre tipi di coppie chiave/valore nel campo .data:

• Le chiavi di commento con prefisso _ contengono esempi, note e avvisi.
• Le chiavi di stringa contengono valori in testo normale.
• Le chiavi dell'oggetto contengono un valore JSON o YAML che è stato codificato come stringa.

Esempio:

_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

Nota: Kubernetes richiede che tutti i valori di configmap siano stringhe. Kf convalida la struttura dei campi prima dell'aggiornamento dell'oggetto.

Sezione di esempio

La sezione di esempio sotto la chiave _example contiene spiegazioni per altri campi ed esempi. Le modifiche a questa sezione non hanno alcun effetto.

Container Registry dello spazio

La proprietà spaceContainerRegistry è un valore di testo normale che specifica la Container Registry predefinito utilizzato da ogni spazio per archiviare le immagini create.

Esempio:

spaceContainerRegistry: gcr.io/my-project

Domini del cluster dello spazio

La proprietà spaceClusterDomains è un array YAML codificato in stringa di oggetti di dominio.

Ogni spazio nel cluster aggiunge tutti gli elementi dell'array al proprio elenco di domini a cui gli sviluppatori possono associare le proprie app.

Campi
domain	string Il nome di dominio da rendere disponibile. Può contenere una delle seguenti sostituzioni: $(SPACE_NAME): sostituito in ogni spazio con il nome dello spazio. $(CLUSTER_INGRESS_IP): l'indirizzo IP del gateway in entrata del cluster.
gatewayName	string (facoltativo) Override delle route del gateway Istio saranno associate. Il valore predefinito è kf/external-gateway, ma qualsiasi nello spazio dei nomi kf.

Nota: tutti i domini devono contenere la sostituzione $(SPACE_NAME) per impedire alle app in spazi dei nomi diversi di ascoltare lo stesso nome host, il che causa un comportamento non definito.

Esempio:

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 del ciclo di vita di Buildpack V2

La proprietà buildpacksV2LifecycleBuilder contiene la versione di Cloud Foundry Il programma binario builder utilizzato esegue le build di buildpack v2.

Il valore è un riferimento Git. Per utilizzare una versione specifica, aggiungi alla fine un simbolo @ seguito da un SHA di Git.

Esempio:

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

Avvio del ciclo di vita dei buildpack V2

La proprietà buildpacksV2LifecycleLauncher contiene la versione di Cloud Foundry File binario launcher integrato in ogni applicazione buildpack V2.

Il valore è un riferimento Git. Per usare una versione specifica, aggiungi un simbolo @ seguito da una SHA Git alla fine.

Esempio:

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

Elenco dei buildpack V2

La proprietà spaceBuildpacksV2 è un array YAML con codifica a stringa che contiene un elenco ordinato di buildpack predefiniti utilizzati per creare applicazioni compatibili con il processo dei buildpack V2.

Campi
name	string Un nome breve che gli sviluppatori possono usare per fare riferimento al buildpack nei manifest dell'applicazione.
url	string L'URL utilizzato per recuperare il buildpack.
disabled	boolean Utilizzato per impedire l'esecuzione di questo buildpack.

Elenco di serie V2

La proprietà spaceBuildpacksV2 è un array YAML con codifica stringa che contiene un elenco ordinato di stack che possono essere utilizzati con build compatibili con Cloud Foundry.

Campi
name	string Un nome breve che gli sviluppatori possono utilizzare per fare riferimento allo stack nei manifest dell'applicazione.
image	string URL dell'immagine container da utilizzare come stack. Per ulteriori informazioni, vedi https://kubernetes.io/docs/concepts/containers/images.

Nota: utilizza le immagini taggate con gli SHA per migliorare la memorizzazione nella cache.

Elenco di Stacks V3

La proprietà spaceStacksV3 è un array YAML con codifica stringa che contiene un ordine di stack che possono essere utilizzati Buildpack cloud-native le build.

Campi
name	string Un nome breve che gli sviluppatori possono utilizzare per fare riferimento allo stack nei manifest delle applicazioni.
description	string Una breve descrizione dello stack mostrata quando viene eseguito kf stacks.
buildImage	string URL dell'immagine del container da utilizzare come generatore. Per ulteriori informazioni, vedi https://kubernetes.io/docs/concepts/containers/images.
runImage	string URL dell'immagine del contenitore da utilizzare come base per tutte le app create con . Per ulteriori informazioni, vedi https://kubernetes.io/docs/concepts/containers/images.
nodeSelector	map (key: string, value: string) (facoltativo) Un NodeSelector utilizzato per indicare con quali nodi sono state create le applicazioni su cui può essere eseguito questo stack.

Nota: utilizza immagini codificate con SHA per migliorare la memorizzazione nella cache.

Esempio:

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

Impostazione predefinita sull'organizzazione V3

La proprietà spaceDefaultToV3Stack contiene un valore tra virgolette true o false che indica se gli spazi devono utilizzare stack V3 nel caso in cui un utente non ne specifichi uno.

Flag funzionalità

La proprietà featureFlags contiene una mappa YAML con codifica stringa di flag delle funzionalità che possa abilitare e disabilitare le funzionalità di Kf.

I nomi dei flag non supportati da Kf verranno ignorati.

Nome del flag	Predefinito	Finalità
disable_custom_builds	false	Disabilita l'accesso degli sviluppatori alle pipeline di build Tekton arbitrarie.
enable_dockerfile_builds	true	Consenti agli sviluppatori di creare codice sorgente dai file Docker.
enable_custom_buildpacks	true	Consenti agli sviluppatori di specificare buildpack esterni nelle loro applicazioni.
enable_custom_stacks	true	Consenti agli sviluppatori di specificare stack personalizzati nelle loro applicazioni.

Esempio:

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