Skip to content

A subordinate Juju operator for requesting and mounting exported NFS shares on virtual machines.

License

Notifications You must be signed in to change notification settings

canonical/nfs-client-operator

Repository files navigation

NFS client operator

A subordinate Juju operator for requesting and mounting exported NFS shares on virtual machines.

Charmhub Badge CI Release Matrix

Features

The NFS client operator requests and mounts exported NFS shares on virtual machines. This operator embeds the nfs-common package which contains several support files common to both NFS clients and servers. Network File System (NFS) itself is a distributed file system protocol for sharing files between heterogeneous environments over a network.

Usage

NFS client operator is a subordinate operator; it must be integrated with a principle operator for it to deploy successfully. For more information on how Juju operators work and how manage them, please refer to the Juju documentation. This operator should be used with Juju 3.x or greater.

With NFS server proxy operator

$ juju deploy nfs-server-proxy --config endpoint=nfs://12.34.56.78/data
$ juju deploy nfs-client data --config mountpoint=/data
$ juju deploy ubuntu base --base ubuntu@22.04
$ juju integrate data:juju-info base:juju-info
$ juju integrate data:nfs-share nfs-server-proxy:nfs-server-proxy

With LXD containers

If you are deploying Juju operators to an LXD container-based cloud substrate, you must modify the default LXD profile. The LXD containers must be super-privileged and have their AppArmor profile modified to allow nfs and rpc_pipefs mounts to successfully mount NFS shares. You can use the following commands to modify the default LXD profile to allow NFS mounts:

$ lxc profile set default security.privileged true
$ lxc profile set default raw.apparmor 'mount fstype=nfs*, mount fstype=rpc_pipefs'

Project & Community

The NFS client operator is a project of the Ubuntu HPC community. It is an open source project that is welcome to community involvement, contributions, suggestions, fixes, and constructive feedback. Interested in being involved with the development of the NFS client operator? Check out these links below:

License

The NFS client operator is free software, distributed under the Apache Software License, version 2.0. See the LICENSE file for more information.

About

A subordinate Juju operator for requesting and mounting exported NFS shares on virtual machines.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages