From cc73939a54c57c465cd52a500b526b724127bd3d Mon Sep 17 00:00:00 2001 From: komalverma04 Date: Fri, 9 Aug 2024 11:58:47 +0000 Subject: [PATCH 1/3] Add FAQ on connecting your own Kubernetes cluster to Meshery Playground Signed-off-by: komalverma04 --- site/src/assets/data/faq/index.js | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/site/src/assets/data/faq/index.js b/site/src/assets/data/faq/index.js index 69c7c22..97f9ad0 100644 --- a/site/src/assets/data/faq/index.js +++ b/site/src/assets/data/faq/index.js @@ -92,6 +92,21 @@ So, in short, you can share access to your Kubernetes cluster with other users, link: "https://meshery.io", linktext: "Get Started with Meshery", }, + { + question: + "How do I connect my Kubernetes cluster to the Meshery Playground?", + category: "Meshery Playground", + answer: ` +To connect your Kubernetes cluster to the Meshery Playground, follow these steps: + - **Generate a Kubeconfig File**: Run the following command to generate a kubeconfig file for your cluster, including the necessary context information for connecting to your publicly accessible Kubernetes API: + \`\`\`bash + kubectl config view --minify --flatten > config_minikube.yaml + \`\`\` + - **Upload the Kubeconfig File**: Navigate to **Settings > Environment > Out of Cluster Deployment** in the Meshery Web UI, and use the **Upload kubeconfig** option to upload the file you generated. + `, + link: "https://docs.meshery.io/installation/kubernetes", + linktext: "Meshery documentation", + }, ], }; From ba39a35d69eb3d75ca3047b3ca764c6000082ec2 Mon Sep 17 00:00:00 2001 From: komalverma04 Date: Thu, 15 Aug 2024 20:12:43 +0000 Subject: [PATCH 2/3] Add more information Signed-off-by: komalverma04 --- site/src/assets/data/faq/index.js | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) diff --git a/site/src/assets/data/faq/index.js b/site/src/assets/data/faq/index.js index 97f9ad0..ed64bd8 100644 --- a/site/src/assets/data/faq/index.js +++ b/site/src/assets/data/faq/index.js @@ -102,8 +102,23 @@ To connect your Kubernetes cluster to the Meshery Playground, follow these steps \`\`\`bash kubectl config view --minify --flatten > config_minikube.yaml \`\`\` - - **Upload the Kubeconfig File**: Navigate to **Settings > Environment > Out of Cluster Deployment** in the Meshery Web UI, and use the **Upload kubeconfig** option to upload the file you generated. - `, + 1. **Ensure Network Accessibility:** + - Your Kubernetes API server must be publicly accessible or reachable over the network. This usually involves configuring the API server with a public endpoint and ensuring it’s accessible from external networks. + - Adjust your firewall settings, security groups, or VPN configurations to allow traffic from the Meshery Playground environment to your API server (typically on port 6443). + +2. **Upload kubeconfig:** + - Use the Meshery Playground Web UI to upload your kubeconfig file, which contains the necessary context and credentials for Meshery to authenticate and connect to your Kubernetes cluster. + +3. **Verify TLS/SSL Certificates:** + - Ensure that your kubeconfig includes the correct TLS/SSL certificates, so Meshery can securely connect to your API server. + +4. **DNS and IP Configuration:** + - If your Kubernetes API server is exposed via a domain name, make sure that this domain is resolvable and that Meshery Playground can reach it. + +5. **Authentication and Permissions:** + - The kubeconfig should contain valid credentials (such as tokens or certificates) to authenticate Meshery Playground with your Kubernetes API. Ensure that these credentials have the necessary permissions to interact with the cluster. + +`, link: "https://docs.meshery.io/installation/kubernetes", linktext: "Meshery documentation", }, From c947c6aa82c1d8adc7e6e1abec02b75f129e20e2 Mon Sep 17 00:00:00 2001 From: komalverma04 Date: Thu, 15 Aug 2024 20:20:58 +0000 Subject: [PATCH 3/3] Fix indexing Signed-off-by: komalverma04 --- site/src/assets/data/faq/index.js | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/site/src/assets/data/faq/index.js b/site/src/assets/data/faq/index.js index ed64bd8..001ce96 100644 --- a/site/src/assets/data/faq/index.js +++ b/site/src/assets/data/faq/index.js @@ -98,24 +98,24 @@ So, in short, you can share access to your Kubernetes cluster with other users, category: "Meshery Playground", answer: ` To connect your Kubernetes cluster to the Meshery Playground, follow these steps: - - **Generate a Kubeconfig File**: Run the following command to generate a kubeconfig file for your cluster, including the necessary context information for connecting to your publicly accessible Kubernetes API: + 1. **Generate a Kubeconfig File**: Run the following command to generate a kubeconfig file for your cluster, including the necessary context information for connecting to your publicly accessible Kubernetes API: \`\`\`bash kubectl config view --minify --flatten > config_minikube.yaml \`\`\` - 1. **Ensure Network Accessibility:** + 2. **Ensure Network Accessibility:** - Your Kubernetes API server must be publicly accessible or reachable over the network. This usually involves configuring the API server with a public endpoint and ensuring it’s accessible from external networks. - Adjust your firewall settings, security groups, or VPN configurations to allow traffic from the Meshery Playground environment to your API server (typically on port 6443). -2. **Upload kubeconfig:** + 3. **Upload kubeconfig:** - Use the Meshery Playground Web UI to upload your kubeconfig file, which contains the necessary context and credentials for Meshery to authenticate and connect to your Kubernetes cluster. -3. **Verify TLS/SSL Certificates:** + 4. **Verify TLS/SSL Certificates:** - Ensure that your kubeconfig includes the correct TLS/SSL certificates, so Meshery can securely connect to your API server. -4. **DNS and IP Configuration:** + 5. **DNS and IP Configuration:** - If your Kubernetes API server is exposed via a domain name, make sure that this domain is resolvable and that Meshery Playground can reach it. -5. **Authentication and Permissions:** + 6. **Authentication and Permissions:** - The kubeconfig should contain valid credentials (such as tokens or certificates) to authenticate Meshery Playground with your Kubernetes API. Ensure that these credentials have the necessary permissions to interact with the cluster. `,