Runtime di un'app

Il runtime dell'app è l'ambiente in cui vengono eseguite le app.

	App buildpack	Container Image Apps
Librerie di sistema	Fornito dallo stack	Fornito nel contenitore
Accesso alla rete	Accesso completo tramite il sidecar Envoy	Accesso completo tramite il sidecar Envoy
File system	Spazio di archiviazione temporanea	Archiviazione temporanea
Runtime della lingua	Fornito dallo stack o dal buildpack	Integrati nel container
Utente.	Specificato dall'elenco filtri	Specificato nel container
Meccanismo di isolamento	Pod Kubernetes	Pod Kubernetes
DNS	Fornito da Kubernetes	Fornito da Kubernetes

Variabili di ambiente

Le variabili di ambiente vengono inserite nell'app in fase di runtime da Kubernetes. Le variabili vengono aggiunte in base al seguente ordine, dove i valori successivi hanno la precedenza quelli precedenti con lo stesso nome:

1. Spazio (impostato dagli amministratori)
2. App (impostata dagli sviluppatori)
3. Sistema (impostato da Kf)

Kf fornisce le seguenti variabili di ambiente di sistema:

Variabile	Finalità
CF_INSTANCE_ADDR	L'indirizzo IP:PORT visibile al cluster dell'istanza dell'app.
CF_INSTANCE_GUID	L'UUID dell'istanza dell'app.
INSTANCE_GUID	Alias di CF_INSTANCE_GUID.
CF_INSTANCE_INDEX	Il numero di indice dell'istanza dell'app, che sarà SEMPRE 0.
INSTANCE_INDEX	Alias di CF_INSTANCE_INDEX.
CF_INSTANCE_IP	L'indirizzo IP visibile al cluster dell'istanza dell'app.
CF_INSTANCE_INTERNAL_IP	Alias di CF_INSTANCE_IP
VCAP_APP_HOST	Alias di CF_INSTANCE_IP
CF_INSTANCE_PORT	La porta visibile al cluster dell'istanza dell'app. In Kf è uguale a PORT.
DATABASE_URL	Il primo URI trovato in una credenziale VCAP_SERVICES.
LANG	Obbligatorio per Buildpack per garantire un ordine di caricamento degli script coerente.
MEMORY_LIMIT	La quantità massima di memoria in MB che l'app può consumare.
PORT	La porta su cui l'app deve rimanere in ascolto per le richieste.
VCAP_APP_PORT	Alias di PORT.
VCAP_APPLICATION	Una struttura JSON contenente i metadati dell'app.
VCAP_SERVICES	Una struttura JSON che specifica i servizi associati.

Le credenziali dei servizi dei servizi associati vengono iniettate nelle app tramite la variabile di ambiente VCAP_SERVICES. La variabile è un oggetto JSON valido con la seguente struttura.

VCAPServices

Un oggetto JSON in cui le chiavi sono etichette di servizio e i valori sono un array di VCAPService. L'array rappresenta ogni limite con quella etichetta. Servizi forniti dall'utente sotto l'etichetta user-provided.

Esempio

{
  "mysql": [...],
  "postgresql": [...],
  "user-provided": [...]
}

VCAPService

Questo tipo rappresenta una singola istanza di servizio associata.

Esempio

{
  "binding_name": string,
  "instance_name": string,
  "name": string,
  "label": string,
  "tags": string[],
  "plan": string,
  "credentials": object
}

Campi

Campo	Tipo	Descrizione
binding_name	string	Il nome assegnato all'associazione del servizio dall'utente.
instance_name	string	Il nome assegnato all'istanza di servizio dall'utente.
name	string	binding_name, se esistente; altrimenti instance_name.
label	string	Il nome dell'offerta di servizi.
tags	string[]	Un array di stringhe che un'app può utilizzare per identificare un'istanza di servizio.
plan	string[]	Il piano di servizio selezionato al momento della creazione dell'istanza di servizio.
credentials	object	Le credenziali specifiche del servizio necessarie per accedere all'istanza di servizio.

Nota: usa il campo tags per scoprire i servizi nella tua app anziché filtrare per pianificare/etichettare in modo da poter scambiare implementazioni e provider in base all'ambiente.

Nota: il campo credentials è spesso un oggetto con chiavi e valori stringa. Tuttavia, i valori possono essere di qualsiasi tipo.

VCAP_APPLICATION

La variabile di ambiente VCAP_APPLICATION è un oggetto JSON contenente i metadati dell'app.

Esempio

{
  "application_id": "12345",
  "application_name": "my-app",
  "application_uris": ["my-app.example.com"],
  "limits": {
    "disk": 1024,
    "mem": 256
  },
  "name": "my-app",
  "process_id": "12345",
  "process_type": "web",
  "space_name": "my-ns",
  "uris": ["my-app.example.com"]
}

Campi

Campo	Tipo	Descrizione
application_id	string	Il GUID che identifica l'app.
application_name	string	Il nome assegnato all'app quando è stata inviata.
application_uris	string[]	Gli URI assegnati all'app.
limits	object	I limiti allo spazio su disco e alla memoria consentiti all'App. I limiti di memoria e spazio su disco vengono forniti al momento del deployment dell'app, nella riga di comando o nel manifest dell'app. I limiti di disco e memoria sono rappresentati come numeri interi, dove si presume l'unità di MB.
name	string	Identico a application_name.
process_id	string	L'UID che identifica il processo. Presente solo nei contenitori delle app in esecuzione.
process_type	string	Il tipo di processo. Presente solo nei container di app in esecuzione.
space_name	string	Il nome leggibile dello spazio in cui è stato eseguito il deployment dell'app.
uris	string[]	Identico a application_uris.

Campi mancanti

Alcuni campi di VCAP_APPLICATION che si trovano in Cloud Foundry non sono attualmente supportati in Kf.

Oltre ai campi specifici di CF e ritirati (cf_api, host, users), i campi non supportati in Kf sono:

• application_version (identico a version)
• organization_id
• organization_name
• space_id
• start (identico a started_at)
• started_at_timestamp (identico a state_timestamp)