Skip to content

Namespaces

The RCTL utility provides the means to manage the lifecycle of namespaces across the fleet of managed clusters. The following operations can be performed on namespaces managed by the controller on the fleet of clusters.

Resource Create Get Update Delete Status Publish Unpublish
Namespace YES YES YES YES YES YES YES

Managed Namespaces

As a multi cluster operations platform, the Controller creates/deletes namespaces on managed Kubernetes clusters.

For immediate operations on a namespace on a cluster, use the Zero Trust KubeCTL to manage these directly.

Create Namespace

Namespace can be created in three (3) types

  1. RafayWizard
  2. Repo
  3. Upload

Deploying the namespace can be done for a specific cluster or by cluster labels. For placement on specific cluster use placementType: ClusterSpecific For labels use placementType: ClusterLabels

Create a new "managed" namespace in the current Project using the Yaml config spec

Declarative

./rctl create ns -f <path-to-namespace-yaml>
Type: RafayWizard

Below is an example of namespace yaml file with the type RafayWizard and placementType ClusterSpecific

kind: ManagedNamespace
apiVersion: config.rafay.dev/v2
metadata:
  name: abc
  description: desc-01
  labels:
    env: dev
    priority: high
    severity: low
  annotations:
    a1: v3
    a2: v4
spec:
  type: RafayWizard
  resourceQuota:
    cpuRequests: 2
    memoryRequests: 2
    cpuLimits: 1
    memoryLimits: 2
  limitRange:
    podLimits:
      maxCpu: 3
      maxMemory: 2
      minCpu: 1
      minMemory: 1
      maxLimitRequestRatioCpu: 1
      maxLimitRequestRatioMemory: 1
    containerLimits:
      maxCpu: 2
      maxMemory: 2
      minCpu: 2
      minMemory: 2
      defaultCpu: 2
      defaultMemory: 2
      defaultRequestCpu: 2
      defaultRequestMemory: 2
      maxLimitRequestRatioCpu: 1
      maxLimitRequestRatioMemory: 1
  placement:
    placementType: ClusterSpecific
    clusterLabels:
    - key: clusterName
      value: demo-cluster-01

Type: Repo

Below is an example of namespace yaml file with the type Repo and placementType ClusterLabels

kind: ManagedNamespace
apiVersion": config.rafay.dev/v2
metadata:
  name:rctl-repo2
spec:
  type: Repo
  repoRef:git-cred
  repoArtifactMeta:
    git:
      revision: main3
      repoArtifactFiles:
      - name: abc.yaml
        relPath: NameSpace/abc.yaml
        fileType: K8sYAMLFile
  placement:
    placementType: ClusterLabels
    clusterLabels:
    - key: clusterId
      value: qweed

Type: Upload

Below is an example of namespace yaml file with the type Upload and placementType ClusterSpecific

kind: ManagedNamespace
apiVersion": config.rafay.dev/v2
metadata:
  name: upload-ns-03
spec:
  type: Upload
  namespaceFromFile: "/Users/Downloads/abc.yaml"
  placement:
    placementType: ClusterSpecific
    clusterLabels:
    - key: clusterName
      value: xyz
  ```

!!! Important
    Avoid upper case characters for the name because Kubernetes does not support it

---


## List Namespace

The below command is to retrieve/list all "managed namespaces" in the currently specified "Project". An illustrative example is shown below.
./rctl get namespace 
***Output***
+--------------------------------+-------------+------------------------------+------------------+---------+--------+-------------+ | NAME | TYPE | CREATEDAT | DEPLOYEDCLUSTERS | ID | LABELS | ANNOTATIONS | +--------------------------------+-------------+------------------------------+------------------+---------+--------+-------------+ | yaml-workloads | RafayWizard | Wed Mar 24 17:31:51 UTC 2021 | | qkollkn | | | +--------------------------------+-------------+------------------------------+------------------+---------+--------+-------------+ | wiz-workloads | Upload | Thu Apr 1 08:07:43 UTC 2021 | demo-cluster | gkje620 | | | +--------------------------------+-------------+------------------------------+------------------+---------+--------+-------------+ | heml-workloads | Repo | Thu Apr 1 08:55:22 UTC 2021 | demo-cluster | 6kn062l | | | +--------------------------------+-------------+------------------------------+------------------+---------+--------+-------------+ 
The below command is to retrieve a specific namespace from a project. When viewing a specific namespace, labels and annotations associated with the namespace are also shown
./rctl get namespace demo 
***Example: Output of Upload type***
+---------------------+--------+------------------------------+------------------+---------+--------------------------------+----------------+ | NAME | TYPE | CREATEDAT | DEPLOYEDCLUSTERS | ID | LABELS | ANNOTATIONS | +---------------------+--------+------------------------------+------------------+---------+--------------------------------+----------------+ | demo | Upload | Thu Sep 16 15:34:18 UTC 2021 | | 3mx9evm | [severity:low, env:dev, | [a1:v3, a2:v4] | | | | | | | priority:high] | | +---------------------+--------+------------------------------+------------------+---------+--------------------------------+----------------+ 
---

## Update Namespace

Use the below command to update a namespace with any changes performed in the yaml file
./rctl update ns -f 
---

## Delete Namespace

Delete a "managed namespace" in the current project context using the following command. Users are allowed to delete one or more namespaces at once. Below is an example of multiple namespace deletion
Deleting a namespace will also delete the namespace from the clusters where the namespace is published.
./rctl delete ns 
!!! Important
    Managed namespaces cannot be deleted if they are in active use by workloads or blueprints

---

## Namespace Status

To know the status of a namespace, use the below command
./rctl status ns 
***Output***
+---------+------+----------------+------------------+------------------+----------------+ | NAME | TYPE | PUBLISHPENDING | ASSIGNEDCLUSTERS | DEPLOYEDCLUSTERS | FAILEDCLUSTERS | +---------+------+----------------+------------------+------------------+----------------+ | demo | Repo | false | demo-cluster | demo-ckuster | | +---------+------+----------------+------------------+------------------+----------------+ 
## Publish/Unplublish Namespace

Users can publish (or) unpublish a namespace with below commands

- Publish
./rctl publish ns 
- Unpublish
./rctl unpublish ns ```

Note: For help commands, append -h or --help after any of these commands. Example: .rctl get namespace -h or .rctl get namespace --help