PR[1] in volume nfs plugin will remove it too. Since it can cause inconsistencies. This change will not affect exports created using dashboard. As it looks for ganesha config object just by 'conf-' [2]. Exports cannot be created by using volume/nfs plugin in Octopus version. Because the ceph rook module is broken. [1] https://github.com/ceph/ceph/pull/38510 [2] https://github.com/ceph/ceph/blob/octopus/src/pybind/mgr/dashboard/services/ganesha.py#L1111 Signed-off-by: Varsha Rao <varao@redhat.com>
102 lines
4.0 KiB
Markdown
102 lines
4.0 KiB
Markdown
---
|
|
title: NFS CRD
|
|
weight: 3100
|
|
indent: true
|
|
---
|
|
|
|
# Ceph NFS Gateway CRD
|
|
|
|
## Overview
|
|
|
|
Rook allows exporting NFS shares of the filesystem or object store through the CephNFS custom resource definition. This will spin up a cluster of [NFS Ganesha](https://github.com/nfs-ganesha/nfs-ganesha) servers that coordinate with one another via shared RADOS objects. The servers will be configured for NFSv4.1+ access, as serving earlier protocols can inhibit responsiveness after a server restart.
|
|
|
|
## Samples
|
|
|
|
The following sample will create a two-node active-active cluster of NFS Ganesha gateways. A CephFS named `myfs` is used, and the recovery objects are stored in a RADOS pool named `myfs-data0` with a RADOS namespace of `nfs-ns`.
|
|
|
|
This example requires the filesystem to first be configured by the [Filesystem](ceph-filesystem-crd.md).
|
|
|
|
> **NOTE**: For an RGW object store, a data pool of `my-store.rgw.buckets.data` can be used after configuring the [Object Store](ceph-object-store-crd.md).
|
|
|
|
```yaml
|
|
apiVersion: ceph.rook.io/v1
|
|
kind: CephNFS
|
|
metadata:
|
|
name: my-nfs
|
|
namespace: rook-ceph
|
|
spec:
|
|
rados:
|
|
# RADOS pool where NFS client recovery data is stored.
|
|
pool: myfs-data0
|
|
# RADOS namespace where NFS client recovery data is stored in the pool.
|
|
namespace: nfs-ns
|
|
# Settings for the NFS server
|
|
server:
|
|
# the number of active NFS servers
|
|
active: 2
|
|
# A key/value list of annotations
|
|
annotations:
|
|
# key: value
|
|
# where to run the NFS server
|
|
placement:
|
|
# nodeAffinity:
|
|
# requiredDuringSchedulingIgnoredDuringExecution:
|
|
# nodeSelectorTerms:
|
|
# - matchExpressions:
|
|
# - key: role
|
|
# operator: In
|
|
# values:
|
|
# - mds-node
|
|
# tolerations:
|
|
# - key: mds-node
|
|
# operator: Exists
|
|
# podAffinity:
|
|
# podAntiAffinity:
|
|
# topologySpreadConstraints:
|
|
|
|
# The requests and limits set here allow the ganesha pod(s) to use half of one CPU core and 1 gigabyte of memory
|
|
resources:
|
|
# limits:
|
|
# cpu: "500m"
|
|
# memory: "1024Mi"
|
|
# requests:
|
|
# cpu: "500m"
|
|
# memory: "1024Mi"
|
|
# the priority class to set to influence the scheduler's pod preemption
|
|
priorityClassName:
|
|
```
|
|
|
|
## NFS Settings
|
|
|
|
### RADOS Settings
|
|
|
|
* `pool`: The pool where ganesha recovery backend and supplemental configuration objects will be stored
|
|
* `namespace`: The namespace in `pool` where ganesha recovery backend and supplemental configuration objects will be stored
|
|
|
|
## EXPORT Block Configuration
|
|
|
|
All daemons within a cluster will share configuration with no exports defined, and that includes a RADOS object via:
|
|
|
|
```ini
|
|
%url rados://<pool>/<namespace>/conf-nfs.<clustername>
|
|
```
|
|
|
|
> **NOTE**: This format of nfs-ganesha config object name was introduced in Ceph Octopus Version. In older versions, each daemon has it's own config object and with the name as *conf-<clustername>.<nodeid>*. The nodeid is a value automatically assigned internally by rook. Nodeids start with "a" and go through "z", at which point they become two letters ("aa" to "az").
|
|
|
|
The pool and namespace are configured via the spec's RADOS block.
|
|
|
|
When a server is started, it will create the included object if it does not already exist. It is possible to prepopulate the included objects prior to starting the server. The format for these objects is documented in the [NFS Ganesha](https://github.com/nfs-ganesha/nfs-ganesha/wiki) project.
|
|
|
|
## Scaling the active server count
|
|
|
|
It is possible to scale the size of the cluster up or down by modifying
|
|
the `spec.server.active` field. Scaling the cluster size up can be done at
|
|
will. Once the new server comes up, clients can be assigned to it
|
|
immediately.
|
|
|
|
The CRD always eliminates the highest index servers first, in reverse
|
|
order from how they were started. Scaling down the cluster requires that
|
|
clients be migrated from servers that will be eliminated to others. That
|
|
process is currently a manual one and should be performed before
|
|
reducing the size of the cluster.
|