vscode-extension - migrating vscode-extension from ocm-io org to lab repo (#30)

Signed-off-by: Mike Ng <[email protected]>

Author: mikeshng

README.md

@@ -29,6 +29,7 @@ For new add-on projects, please use the
 
 - [dashboard](./dashboard/README.md): OCM UI Dashboard.
 - [fleetconfig-controller](./fleetconfig-controller/README.md): Declarative orchestrator for OCM multi-clusters.
+- [vscode-extension](./vscode-extension/README.md): OCM VScode extension.
 
 ## Onboarding a New Project
 

vscode-extension/.editorconfig

@@ -0,0 +1,19 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_size = 4
+indent_style = tab
+max_line_length = 100
+
+[**.{yaml,yml}]
+indent_size = 2
+indent_style = space
+
+[**.md]
+indent_size = 2
+indent_style = space
+max_line_length = 120

vscode-extension/.eslintrc.json

@@ -0,0 +1,47 @@
+{
+    "root": true,
+	"extends": "eslint:recommended",
+    "parser": "@typescript-eslint/parser",
+    "parserOptions": {
+		"project": "./tsconfig.json"
+    },
+    "plugins": [
+        "@typescript-eslint"
+    ],
+    "rules": {
+		"@typescript-eslint/adjacent-overload-signatures": "error",
+		"@typescript-eslint/await-thenable": "error",
+		//"@typescript-eslint/ban-ts-comment": "warn",
+		"@typescript-eslint/no-empty-interface": "error",
+		"@typescript-eslint/no-extra-non-null-assertion": "error",
+		"@typescript-eslint/no-for-in-array": "error",
+		"@typescript-eslint/no-misused-new": "error",
+		"@typescript-eslint/no-non-null-asserted-optional-chain": "error",
+		"@typescript-eslint/no-non-null-assertion": "warn",
+		"@typescript-eslint/no-this-alias": "error",
+		"@typescript-eslint/no-unnecessary-type-assertion": "error",
+		"@typescript-eslint/no-unnecessary-type-constraint": "error",
+		"@typescript-eslint/no-var-requires": "error",
+		"@typescript-eslint/prefer-as-const": "error",
+		"@typescript-eslint/prefer-namespace-keyword": "error",
+		"@typescript-eslint/restrict-plus-operands": "error",
+		"@typescript-eslint/restrict-template-expressions": "error",
+		"@typescript-eslint/triple-slash-reference": "error",
+		"@typescript-eslint/unbound-method": "error",
+		"@typescript-eslint/explicit-function-return-type": "warn",
+		"@typescript-eslint/naming-convention": "warn",
+        "@typescript-eslint/semi": "warn",
+        "curly": "warn",
+        "eqeqeq": "warn",
+        "no-async-promise-executor": "off",
+		"no-throw-literal": "warn",
+		"no-undef":"off",
+		"no-unused-vars": "off",
+		"sort-imports":"warn"
+    },
+    "ignorePatterns": [
+        "out",
+        "dist",
+        "**/*.d.ts"
+    ]
+}

vscode-extension/OWNERS

@@ -0,0 +1,9 @@
+approvers:
+- ilan-pinto
+- TomerFi
+- vbelouso
+
+reviewers:
+- ilan-pinto
+- TomerFi
+- vbelouso

vscode-extension/README.md

@@ -0,0 +1,174 @@
+# OCM VScode Extension
+
+In the process of migrating from https://github.com/open-cluster-management-io/ocm-vscode-extension
+
+OCM VScode Extension is a UI tool for OCM related Kubernetes resources that has been built upon Visual Studio Code and offers additional OCM administrative and monitoring features in order to improve operational efficiency and accelerate development within engineering teams.
+
+Get a full introduction to [OCM VScode Extension on YOUTUBE][youtube-ocm-vscode-ext-intro]
+
+<br><div>
+   <img src="images/ocm-vscode-ext-intro.gif" alt="Create Local Environment" style="margin: 0 auto; width: 1264px">
+</div><br>
+
+- [OCM VScode Extension](#ocm-vscode-extension)
+  - [Prerequisites](#prerequisites)
+  - [Installation](#installation)
+    - [Install Latest version](#install-latest-version)
+    - [Install specific version](#install-specific-version)
+  - [Features](#features)
+    - [Resources Snippets](#resources-snippets)
+    - [Bootstrap Project](#bootstrap-project)
+    - [Create Local Environment](#create-local-environment)
+    - [Manage Existing Resources](#manage-existing-resources)
+  - [Recommendations](#recommendations)
+  - [Contributing](#contributing)
+
+<br>
+
+## Prerequisites
+
+You must meet the following prerequisites to install OCM VScode Extension:
+
+* Ensure your [`Visual Studio Code`][install-vscode] release is at least `v1.71.0`.
+
+You must meet some additional prerequisites to utilize OCM VScode Extension features:
+
+| Feature | Prerequisites |
+| ------- | ------------ |
+| Resources Snippets | None |
+| Bootstrap Project | None |
+| Manage Existing Resources | [kubectl][install-kubectl] |
+| Create Local Environment | [kubectl][install-kubectl], [clusteradm][install-clusteradm], [kind][install-kind] |
+
+<br>
+
+## Installation
+
+### Install Latest version
+In your VScode instance, go to the _Extensions Marketplace_ (by clicking on the _Extensions_ icon in the composite bar on the left hand side or simply pressing Ctrl+Shift+X on your keyboard).
+
+Search for _OCM Extension_ and click install.
+
+### Install specific version
+To download a specific version of VScode Extension visit the [releases page][releases], expand the _Assets_ section of the target version,
+and download the version for your operating system.
+
+In your VScode instance, go to the _Extensions Marketplace_ (by clicking on the _Extensions_ icon in the composite bar on the left hand side or simply pressing Ctrl+Shift+X on your keyboard).
+
+Click the **...** at the top right corner of the palette, select the _Install from VSIX..._ action, and browse for the specific _VSIX_ file you downloaded.
+
+Select a _VSIX_ file and hit install.
+
+<br>
+
+## Features
+
+### Resources Snippets
+
+OCM VScode Extension allows users to load Custom Resource (CR) snippets from the command palette.
+
+The resources available as snippets are:
+  * Subscription
+  * Placement
+  * Channel
+  * ManagedClusterSet
+  * ManagedClusterSetBinding
+
+Subscription snippets are available specifically tailored to either Git, Helm or ObjectBucket.
+
+To exercise this feature you must take the following steps:
+  1. Create a new yaml file in a desired path 
+  2. Open the file and press Ctrl+Shift+P on your keyboard
+  3. In the search container at the top of your screen choose _Snippets: Insert Snippet_
+  4. Choose a desired snippet from list
+
+<br><div>
+   <img src="images/snippets-from-palette.gif" alt="Resources Snippets">
+</div><br>
+
+### Bootstrap Project
+
+Another valuable feature of OCM VScode Extension is to create a Bootstrap project for the various channel types.
+
+The Bootstrap project is basically a collection of snippets, customized to fit one of three channel types - Git, Helm or ObjectBucket, that form a project template for you to build upon.
+
+To exercise this feature you must take the following steps:
+  1. Press Ctrl+Shift+P on your keyboard
+  2. In the search container at the top of your screen choose _OCM: Create an application-manager project_
+  3. Choose a desired channel type
+  4. Type in a project name and hit enter
+
+<br><div>
+   <img src="images/new-project.gif" alt="Bootstrap Project">
+</div><br>
+
+
+### Create Local Environment
+
+The Create Local Environment feature allows you to create a quick OCM multi-cluster control plane on a local [kind][kind] environment with only a click of a button.
+
+The feature does it all for you:
+  - Verifies the existence of the required tools.
+  - Creates as many [kind][kind] clusters as you need (customizable).
+  - Initializes the _hub cluster_ by installing a [Cluster Manager][cluster-manager] using [clusteradm][clusteradm], and [kubectl][install-kubectl].
+  - Installs a [Klusterlet][klusterlet] agent on the _managed clusters_ and sends join requests to the _hub cluster_ using [clusteradm][clusteradm], and [kubectl][install-kubectl].
+  - Accepts the join requests from the _hub cluster_ using [clusteradm][clusteradm], and [kubectl][install-kubectl].
+
+To exercise this feature you must take the following steps:
+  1. Click on the _OCM_ icon in the composite bar on the left hand side to open OCM VScode Extension control pane
+  2. Locate the _Create Local Environment_ button in the _Developers Tools_ section and give it a click
+  3. Notice that at the top of your screen an action container will prompt you to choose between default or custom configuration
+  4. After configuration was specified, a progress bar at the botom right of your screen will provide feadback on the build process
+
+<br><div>
+   <img src="images/create-local-env.gif" alt="Create Local Environment" style="margin: 0 auto; width: 1264px">
+</div><br>
+
+### Manage Existing Resources
+
+The Manage Existing Resources feature provides a wide and detailed overview of all the resources residing in any one cluster.
+
+To exercise this feature you must take the following steps:
+  1. Access the _Cluster Details_ tab either by:
+      * Pressing Ctrl+Shift+P on your keyboard and choosing _OCM-View: Cluster Details_ in the search container at the top of your screen 
+      * Clicking on the _OCM_ icon in the composite bar on the left hand side to open OCM VScode Extension control pane, locating the _Connected Clusters_ section and selecting any cluster in the list
+  2. Inside the _Cluster Details_ tab, use the dropdown to select any cluster from the list of availabe clusters in order to view the resources within it 
+
+<br><div>
+   <img src="images/mng-existing-resources.gif" alt="Create Local Environment" style="margin: 0 auto; width: 1264px">
+</div><br>
+
+## Recommendations
+
+Take a look at some other great VScode extensions to improve your OCM experience!
+
+* [Visual Studio Code Kubernetes Tools][ext-kubernetes]
+* [OpenShift Toolkit][ext-openshift-toolkit]
+* [YAML Language Support][ext-yaml]
+
+To install the recommended VScode extensions, please visit the _Extensions Marketplace_ (by clicking on the _Extensions_ icon in the composite bar on the left hand side or simply pressing Ctrl+Shift+X on your keyboard).
+
+<br>
+
+## Contributing
+
+See our [Contributing Guidelines][repo-contribute] for more information.
+
+<br>
+
+<!-- LINKS -->
+[ocm-io]: https://open-cluster-management.io/
+[install-vscode]: https://code.visualstudio.com/download
+[install-kubectl]: https://kubernetes.io/docs/tasks/tools/install-kubectl
+[install-kind]: https://kind.sigs.k8s.io/docs/user/quick-start/
+[install-clusteradm]:https://github.com/open-cluster-management-io/clusteradm
+[releases]: https://github.com/open-cluster-management-io/ocm-vscode-extension/releases
+[kind]: https://kind.sigs.k8s.io/
+[cluster-manager]: https://operatorhub.io/operator/cluster-manager
+[clusteradm]: https://github.com/open-cluster-management-io/clusteradm
+[klusterlet]: https://operatorhub.io/operator/klusterlet
+[repo-contribute]: https://github.com/open-cluster-management-io/ocm-vscode-extension/contribute
+[ext-yaml]:https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml
+[ext-openshift-toolkit]:https://marketplace.visualstudio.com/items?itemName=redhat.vscode-openshift-connector
+[ext-kubernetes]:https://marketplace.visualstudio.com/items?itemName=ms-kubernetes-tools.vscode-kubernetes-tools
+[youtube-ocm-vscode-ext-intro]:https://www.youtube.com/watch?v=3WATGbheqbQ