---
argument_specs:
  main:
    short_description: Deploy NFS provisioner (external or in-cluster) for RWX storage on OpenShift
    description:
      - Deploys the nfs-subdir-external-provisioner and a ReadWriteMany StorageClass.
      - When nfs_provisioner_external_server is set, points directly at a pre-existing
        NFS share (no in-cluster NFS server pod is deployed).
      - When nfs_provisioner_external_server is empty, deploys an in-cluster NFS server
        pod backed by an LVMS PVC.
    options:
      nfs_provisioner_namespace:
        description: Namespace for the NFS provisioner (and optional in-cluster NFS server).
        type: str
        default: nfs-provisioner
      nfs_provisioner_external_server:
        description: >-
          IP or hostname of a pre-existing external NFS server. When set, the
          in-cluster NFS server pod is not deployed. Leave empty to use in-cluster mode.
        type: str
        default: ""
      nfs_provisioner_external_path:
        description: >-
          Exported path on the external NFS server.
          Required when nfs_provisioner_external_server is set.
        type: str
        default: ""
      nfs_provisioner_storage_class:
        description: >-
          StorageClass (RWO) for the in-cluster NFS server backing PVC.
          Ignored when nfs_provisioner_external_server is set.
        type: str
        default: lvms-vg-data
      nfs_provisioner_storage_size:
        description: >-
          Size of the in-cluster NFS server backing PVC.
          Ignored when nfs_provisioner_external_server is set.
        type: str
        default: 50Gi
      nfs_provisioner_name:
        description: Provisioner name written into the StorageClass.
        type: str
        default: nfs-client
      nfs_provisioner_storage_class_name:
        description: Name of the RWX StorageClass created by this role.
        type: str
        default: nfs-client
      nfs_provisioner_image:
        description: Container image for the nfs-subdir-external-provisioner.
        type: str
        default: registry.k8s.io/sig-storage/nfs-subdir-external-provisioner:v4.0.2
      nfs_provisioner_server_image:
        description: >-
          Container image for the in-cluster NFS server.
          Ignored when nfs_provisioner_external_server is set.
        type: str
        default: registry.k8s.io/volume-nfs:0.8
      nfs_provisioner_export_path:
        description: >-
          Path exported by the in-cluster NFS server.
          Ignored when nfs_provisioner_external_server is set.
        type: str
        default: /exports
      nfs_provisioner_wait_timeout:
        description: Seconds to wait for deployments to become ready.
        type: int
        default: 300