Gli utenti possono utilizzare servizi non disponibili nel marketplace creando istanze di servizi fornite dall'utente. Una volta create, le istanze di servizio fornite dall'utente si comportano come le istanze di servizio create tramite il marketplace. In Kf sono supportati la creazione, la visualizzazione, l'aggiornamento, l'eliminazione, il collegamento e lo scollegamento dei servizi forniti dall'utente.

Crea un'istanza di servizio fornita dall'utente

L'alias per kf create-user-provided-service è kf cups.

Il nome assegnato a un servizio fornito dall'utente deve essere univoco in tutte le istanze di servizio in uno spazio, inclusi i servizi creati tramite un service broker.

Fornire le credenziali di servizio a un'app

Un'istanza di servizio fornita dall'utente può essere utilizzata per fornire le credenziali a un'app. Ad esempio, un amministratore di database può avere un insieme di credenziali per un database esistente gestito al di fuori di Kf e queste credenziali includono l'URL, la porta, il nome utente e la password utilizzati per connettersi al database.

L'amministratore può creare un servizio fornito dall'utente con le credenziali e lo sviluppatore può associare l'istanza di servizio all'app. In questo modo, le credenziali possono essere condivise senza mai uscire dalla piattaforma. L'associazione di un'istanza di servizio a un'app ha lo stesso effetto indipendentemente dal fatto che il servizio sia fornito dall'utente o sia un servizio del marketplace.

L'app viene configurata con le credenziali fornite dall'utente e la variabile di ambiente di runtime dell'app VCAP_SERVICES viene compilata con informazioni su tutti i servizi associati all'app.

Un servizio fornito dall'utente può essere creato con credenziali e/o un elenco di tag.

kf cups my-db -p '{"username":"admin", "password":"test123", "some-int-val": 1, "some-bool": true}' -t "comma, separated, tags"

Verrà creata l'istanza di servizio fornita dall'utente my-db con le credenziali e i tag forniti. Le credenziali passate al flag -p devono essere JSON valide (in linea o caricate da un percorso file).

Per fornire le credenziali a una o più app, l'utente può eseguire kf bind-service.

Supponiamo di avere un'app con un servizio associato, il servizio fornito dall'utente my-db definito sopra. La variabile di ambiente VCAP_SERVICES per l'app avrà i seguenti contenuti:

{
  "user-provided": [
    {
      "name": "my-db",
      "instance_name": "my-db",
      "label": "user-provided",
      "tags": [
        "comma",
        "separated",
        "tags"
      ],
      "credentials": {
        "username": "admin",
        "password": "test123",
        "some-int-val": 1,
        "some-bool": true
      }
    }
  ]
}

Aggiornare un'istanza di servizio fornita dall'utente

L'alias per kf update-user-provided-service è kf uups.

Un servizio fornito dall'utente può essere aggiornato con il comando uups. Le nuove credenziali e/o i nuovi tag passati sostituiscono completamente quelli esistenti. Ad esempio, se l'utente ha creato il servizio fornito dall'utente my-db sopra, chiamato kf bind-service per associare il servizio a un'app, ha eseguito il comando.

kf uups my-db -p '{"username":"admin", "password":"new-pw", "new-key": "new-val"}'

Le credenziali aggiornate verranno applicate all'app solo dopo che l'utente avrà annullato e ricollegato il servizio all'app. Non è necessario riavviare o eseguire nuovamente il deployment dell'app. La variabile di ambiente VCAP_SERVICES aggiornata avrà i seguenti contenuti:

{
  "user-provided": [
    {
      "name": "my-db",
      "instance_name": "my-db",
      "label": "user-provided",
      "tags": [
        "comma",
        "separated",
        "tags"
      ],
      "credentials": {
        "username": "admin",
        "password": "new-pw",
        "new-key": "new-val"
      }
    }
  ]
}

Le nuove credenziali sovrascrivono le vecchie e i tag rimangono invariati perché non sono stati specificati nel comando di aggiornamento.