Feat/add cluster stacks plugin

.gitignore

@@ -7,3 +7,4 @@ node_modules
 Tests/kaas/results/
 Tests/kaas/kaas-sonobuoy-tests/results/
 *.tar.gz
+.pytest-kind/

Tests/kaas/README.md

@@ -2,15 +2,15 @@
 
 ## Development environment
 
-### requirements
+### Requirements
 
 * [docker](https://docs.docker.com/engine/install/)
 * [kind](https://kind.sigs.k8s.io/docs/user/quick-start/#installation)
 * [sonobuoy](https://sonobuoy.io/docs/v0.57.1/#installation)
 
-### setup for development
+### Setup for Development
 
-1. Generate python 3.10 env
+1. **Generate python 3.10 env**
 
    ```bash
    sudo apt-get install python3.10-dev
@@ -22,17 +22,83 @@
    (venv) python3.10 -m pip --version
    ```
 
-2. Install dependencies:
+2. **Install dependencies:**
 
    ```bash
    (venv) pip install pip-tools
    (venv) pip-compile requirements.in
    (venv) pip-sync requirements.txt
    ```
 
-3. Set environment variables and launch the process:
+3. **Create a Cluster**
+
+   To create a cluster, run:
 
    ```bash
-   (venv) export CLUSTER_PROVIDER="kind"
-   (venv) python run.py
+   (venv) python run_plugin.py create <plugin-name> ../clusterspec.yaml
    ```
+
+## Setting up and running the cluster-stacks plugin
+
+This section covers how to configure and run the `cluster-stacks` plugin to provision Kubernetes clusters and perform conformance tests.
+
+### Requirements for cluster-stacks plugin
+
+In addition to the core requirements, ensure the following are set up:
+
+* An **OpenStack** environment configured and accessible.
+* A `clouds.yaml` file defining OpenStack credentials and endpoints.
+* An installing the envsubst via this command:
+
+  ```bash
+  GOBIN=/tmp go install github.com/drone/envsubst/v2/cmd/envsubst@latest
+  ```
+
+### Environment Variables
+
+Before running the `cluster-stacks` plugin, you need to set up the following environment variable:
+
+* **GIT_ACCESS_TOKEN**: This token is required for Git operations, especially if your repository is private.
+
+To set the `GIT_ACCESS_TOKEN`, run the following command in your terminal:
+
+```bash
+export GIT_ACCESS_TOKEN=<your-github-token>
+```
+
+### Configuring config file for cluster-stacks plugin
+
+The config file is used to set parameters for creating a Kubernetes cluster with the `cluster-stacks` plugin. This file allows you to specify details related to the cluster-stack, Git integration, and cluster configurations. These optional parameters are grouped below by their category.
+
+#### Cluster-Stack Related Parameters
+
+These parameters configure specific settings for the cluster-stack:
+
+```yaml
+cs_name: <cs_name>                  # Cluster Stack Name, default: "scs"
+cs_version: <cs_version>            # Cluster Stack Version
+cs_channel: <cs_channel>            # Release channel
+cs_cloudname: <cs_cloudname>        # Cloud name from OpenStack clouds.yaml
+cs_namespace: "default"             # Namespace for the Cluster Stack deployment
+```
+
+#### Git-Related Parameters
+
+The [Cluster Stack Operator](https://github.com/sovereignCloudStack/cluster-stack-operator/) (CSO) utilizing the [Cluster Stack Provider OpenStack](https://github.com/SovereignCloudStack/cluster-stacks/tree/main/providers/openstack) (CSPO) must be directed to the Cluster Stacks repository housing releases for the OpenStack provider. Modify the following parameters if you wish to redirect CSO and CSPO to an alternative Git repository
+
+```yaml
+git_provider: <git_provider>      # Git provider, default: "github"
+git_org_name: <git_org_name>      # Organization name on Git provider, default: "SovereignCloudStack"
+git_repo_name: <git_repo_name>    # Repository name on Git provider, default: "cluster-stacks"
+```
+
+#### Cluster Parameters
+
+Set these parameters to customize the configuration for your cluster.
+
+```yaml
+cs_pod_cidr: <cs_pod_cidr>                      # Pod CIDR for networking
+cs_service_cidr: <cs_service_cidr>              # Service CIDR for networking
+cs_external_id: <cs_external_id>                # External ID for the Cluster Stack
+cs_k8s_patch_version: <cs_k8s_patch_version>    # Kubernetes patch version to use
+```

Tests/kaas/plugin/cluster.yaml

@@ -0,0 +1,35 @@
+# Cluster resource template
+apiVersion: cluster.x-k8s.io/v1beta1
+kind: Cluster
+metadata:
+  name: ${CS_CLUSTER_NAME}
+  namespace: ${CS_NAMESPACE}
+  labels:
+    managed-secret: cloud-config
+spec:
+  clusterNetwork:
+    pods:
+      cidrBlocks:
+        - ${CS_POD_CIDR}
+    serviceDomain: cluster.local
+    services:
+      cidrBlocks:
+        - ${CS_SERVICE_CIDR}
+  topology:
+    variables:
+      - name: controller_flavor
+        value: "SCS-2V-4-50"
+      - name: worker_flavor
+        value: "SCS-2V-4-50"
+      - name: external_id
+        value: ${CS_EXTERNAL_ID}
+    class: ${CS_CLASS_NAME}
+    controlPlane:
+      replicas: 1
+    version: v${CS_K8S_VERSION}.${CS_K8S_PATCH_VERSION}
+    workers:
+      machineDeployments:
+        - class: default-worker
+          failureDomain: nova
+          name: default-worker
+          replicas: 3

Tests/kaas/plugin/clusterstack.yaml

@@ -0,0 +1,30 @@
+# Cluster-stack and OpenStack cluster-stack release resource templates
+apiVersion: clusterstack.x-k8s.io/v1alpha1
+kind: ClusterStack
+metadata:
+  name: clusterstack
+  namespace: ${CS_NAMESPACE}
+spec:
+  provider: openstack
+  name: ${CS_NAME}
+  kubernetesVersion: "${CS_K8S_VERSION}"
+  channel: ${CS_CHANNEL}
+  autoSubscribe: false
+  providerRef:
+    apiVersion: infrastructure.clusterstack.x-k8s.io/v1alpha1
+    kind: OpenStackClusterStackReleaseTemplate
+    name: cspotemplate
+  versions:
+    - ${CS_VERSION}
+---
+apiVersion: infrastructure.clusterstack.x-k8s.io/v1alpha1
+kind: OpenStackClusterStackReleaseTemplate
+metadata:
+  name: cspotemplate
+  namespace: ${CS_NAMESPACE}
+spec:
+  template:
+    spec:
+      identityRef:
+        kind: Secret
+        name: ${CS_SECRETNAME}

Tests/kaas/plugin/interface.py

@@ -46,9 +46,10 @@ def create_cluster(self, cluster_name, version, kubeconfig_filepath):
         """
         raise NotImplementedError
 
-    def delete_cluster(self, cluster_name):
+    def delete_cluster(self, cluster_name, kubeconfig_filepath):
         """
         This method is to be called in order to unprovision a cluster
         :param: cluster_name:
+        :param: kubeconfig_filepath:
         """
         raise NotImplementedError

Tests/kaas/plugin/plugin-cluster-stacks-config.yaml

@@ -0,0 +1,19 @@
+# This is an example of the config for a cluster-stacks plugins
+
+clouds_yaml_path: "~/.config/openstack/clouds.yaml"  # Path to OpenStack clouds.yaml file
+cs_name: "scs"  # Cluster Stack Name
+cs_version: "v1"  # Cluster Stack Version
+cs_channel: "stable"  # Release channel
+cs_cloudname: "openstack"  # Cloud name from OpenStack clouds.yaml
+cs_namespace: "default"  # Namespace for the Cluster Stack deployment
+
+# Git Configuration
+git_provider: "github"  # Git provider (e.g., GitHub, GitLab)
+git_org_name: "SovereignCloudStack"  # Organization name on Git provider
+git_repo_name: "cluster-stacks"  # Repository name on Git provider
+
+# Cluster Information
+cs_pod_cidr: "192.168.0.0/16"  # Pod CIDR for networking
+cs_service_cidr: "10.96.0.0/12"  # Service CIDR for networking
+cs_external_id: "ebfe5546-f09f-4f42-ab54-094e457d42ec"  # External ID for the Cluster Stack
+cs_k8s_patch_version: "6"  # Kubernetes patch version to use