Configurazione dei volumi NFS

Kf supporta il montaggio di volumi NFS utilizzando kf marketplace.

Prerequisiti

Completa la configurazione della piattaforma NFS.

Crea un'istanza di servizio NFS

Esegui kf marketplace per visualizzare i servizi disponibili. Il servizio NFS integrato viene visualizzato nell'elenco se NFS è abilitato sulla piattaforma.

Broker           Name  Namespace  Description
nfsvolumebroker  nfs              mount nfs shares

Monta un file system esterno

Crea un'istanza di servizio

Per montare su un servizio NFS esistente:

kf create-service nfs existing SERVICE-INSTANCE-NAME -c '{"share":"SERVER/SHARE", "capacity":"CAPACITY"}'

Sostituisci le variabili con i tuoi valori.

  • SERVICE-INSTANCE-NAME è il nome che vuoi per questa istanza del servizio del volume NFS.
  • SERVER/SHARE è l'indirizzo NFS del server e della condivisione.
  • CAPACITY utilizza il formato Quantità Kubernetes.

Conferma che il servizio del volume NFS sia presente nell'elenco dei servizi. Puoi aspettarti un output simile a questo esempio:

$ kf services
...
Listing services in Space: demo-space
Name                Type      ClassName         PlanName  Age    Ready  Reason
filestore-nfs       volume    nfs               existing  6s     True   <nil>
...

Associa l'istanza di servizio a un'app

Per associare un'istanza di servizio NFS a un'app, esegui:

kf bind-service YOUR-APP-NAME SERVICE-NAME -c '{"uid":"2000","gid":"2000","mount":"MOUNT-PATH","readonly":true}'

Sostituisci le variabili con i tuoi valori.

  • YOUR-APP-NAME è il nome dell'app per cui vuoi utilizzare il servizio di volume.

  • SERVICE-NAME è il nome dell'istanza del servizio volume che hai creato nel passaggio precedente.

  • uid:UID e gid:GID specificano le autorizzazioni della directory della condivisione di montaggio.

  • MOUNT-PATH è il percorso in cui il volume deve essere montato all'interno dell'app.

  • (Facoltativo) "readonly":true è una stringa JSON facoltativa che crea un montaggio di sola lettura. Per impostazione predefinita, Servizi volume monta un file system di lettura-scrittura.

Puoi elencare tutte le associazioni in uno spazio utilizzando il comando kf bindings. Vedrai un output simile a questo esempio:

$ kf bindings
...
Listing bindings in Space: demo-space
Name                                     App           Service             Age  Ready
binding-spring-music-filestore-nfs       spring-music  filestore-nfs       71s  True
...

Accedi al servizio di volume dalla tua app

Per accedere al servizio di volume dalla tua app, devi sapere quale percorso file utilizzare nel codice. Puoi visualizzare il percorso del file nei dettagli dell'associazione dei servizi, visibili nelle variabili di ambiente della tua app.

Visualizza le variabili di ambiente per la tua app:

kf vcap-services YOUR-APP-NAME

Sostituisci YOUR-APP-NAME con il nome della tua app.

Di seguito è riportato un esempio di output del comando kf vcap-services:

kf vcap-services *YOUR-APP-NAME*
{
  "nfs": [
    {
      "instance_name": "nfs-instance",
      "name": "nfs-instance",
      "label": "nfs",
      "tags": [],
      "plan": "existing",
      "credentials": {
        "capacity": "1Gi",
        "gid": 2000,
        "mount": "/test/mount",
        "share": "10.91.208.210/test",
        "uid": 2000
      },
      "volume_mounts": [
        {
          "container_dir": "/test/mount",
          "device_type": "shared",
          "mode": "rw"
        }
      ]
    }
  ]
}

Utilizza le proprietà in volume_mounts per qualsiasi informazione richiesta dalla tua app.

Proprietà Descrizione
container_dir Stringa contenente il percorso del volume montato associato all'app.
device_type La release del volume NFS. Al momento sono supportati solo i dispositivi condivisi. Un dispositivo condiviso rappresenta un file system distribuito che può essere montato su tutte le istanze dell'app contemporaneamente.
mode Stringa che indica il tipo di accesso dell'app a NFS, ro (sola lettura) o rw (lettura e scrittura).