diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml deleted file mode 100644 index 777bde7a0..000000000 --- a/.github/workflows/build.yml +++ /dev/null @@ -1,56 +0,0 @@ -name: KubeSphere Website - -on: - push: - branches: - - master - schedule: # run 8:00 AM Beijing Time everyday - - cron: '0 0 * * *' - -jobs: - deploy: - runs-on: ubuntu-18.04 - steps: - - name: Checkout code - uses: actions/checkout@v2 - with: - submodules: true - fetch-depth: 0 - - - name: Setup Hugo - uses: peaceiris/actions-hugo@v2 - with: - hugo-version: '0.71.1' - extended: true - - - name: Sync to gitee - uses: Yikun/hub-mirror-action@master - with: - src: github/kubesphere - dst: gitee/kubesphere - white_list: 'website' - dst_key: ${{ secrets.GITEE_PRIVATE_KEY }} - dst_token: ${{ secrets.GITEE_TOKEN}} - account_type: org - - - name: Build English Website - run: hugo --environment upstream --minify - - - name: Build and Push image - uses: docker/build-push-action@v1 - with: - username: ${{ secrets.DOCKER_USERNAME }} - password: ${{ secrets.DOCKER_PASSWORD }} - repository: kubesphere/website - tags: v1.0-en - - - name: Build Chinese Website - run: hugo --environment upstream-zh --minify - - - name: Build and Push image - uses: docker/build-push-action@v1 - with: - username: ${{ secrets.DOCKER_USERNAME }} - password: ${{ secrets.DOCKER_PASSWORD }} - repository: kubesphere/website - tags: v1.0-zh diff --git a/content/en/docs/_index.md b/content/en/docs/_index.md index 9a8726c46..084109e55 100644 --- a/content/en/docs/_index.md +++ b/content/en/docs/_index.md @@ -17,7 +17,6 @@ sectionLink: list: - /docs/quick-start/all-in-one-on-linux - /docs/quick-start/minimal-kubesphere-on-k8s - - /docs/quick-start/minimal-kubesphere-on-minikube - /docs/quick-start/create-workspace-and-project - /docs/introduction/what-is-kubesphere - /docs/pluggable-components diff --git a/content/en/docs/installing-on-kubernetes/on-prem-kubernetes/installing-kubesphere-on-minikube.md b/content/en/docs/installing-on-kubernetes/on-prem-kubernetes/installing-kubesphere-on-minikube.md new file mode 100644 index 000000000..4ccf191da --- /dev/null +++ b/content/en/docs/installing-on-kubernetes/on-prem-kubernetes/installing-kubesphere-on-minikube.md @@ -0,0 +1,82 @@ +--- +title: "Installing KubeSphere on Minikube" +keywords: 'KubeSphere, Minikube, Minimal, Installation' +description: 'Install KubeSphere on an existing Minikube cluster with a minimal installation package.' +linkTitle: "Installing KubeSphere on Minikube" +weight: 2200, +showSubscribe: true +--- + +In addition to installing KubeSphere on a Linux machine, you can also deploy it on minikube cluster. This tutorial demonstrates the general steps of completing a minimal KubeSphere installation on Minikube. + +## Prerequisites + +- To install KubeSphere 3.2.1 on Minikube, your Minikube version must be v1.23.x, v1.24.x, v1.25.x. +- Make sure your machine meets the minimal hardware requirement: CPU > 2 Core, Memory > 2 GB, 20GB free disk space, Container or virtual machine manager, such as: Docker, Hyperkit, Hyper-V, KVM, Parallels, Podman, VirtualBox, or VMware Fusion/Workstation. +- A **default** Storage Class in your Minikube cluster needs to be configured before the installation. + +{{< notice note >}} + +- The CSR signing feature is activated in `kube-apiserver` when it is started with the `--cluster-signing-cert-file` and `--cluster-signing-key-file` parameters. See [RKE installation issue](https://github.com/kubesphere/kubesphere/issues/1925#issuecomment-591698309). +- For more information about the prerequisites of installing KubeSphere on Minikube, see [Prerequisites](../prerequisites-for-installation-on-minikube). + +{{}} + +## Video Demonstration + +{{< youtube gROOqfupRII>}} + +## Deploy KubeSphere + +After you make sure your machine meets the conditions, perform the following steps to install KubeSphere. + +1. Start minikube. + + ``` bash + ❯ minikube start + 😄 minikube v1.24.0 on Debian 10.1 + 🎉 minikube 1.25.2 is available! Download it: https://github.com/kubernetes/minikube/releases/tag/v1.25.2 + 💡 To disable this notice, run: 'minikube config set WantUpdateNotification false' + + ✨ Using the docker driver based on existing profile + 👍 Starting control plane node minikube in cluster minikube + 🚜 Pulling base image ... + 🔄 Restarting existing docker container for "minikube" ... + 🐳 Preparing Kubernetes v1.22.3 on Docker 20.10.8 ... + 🔎 Verifying Kubernetes components... + ▪ Using image gcr.io/k8s-minikube/storage-provisioner:v5 + 🌟 Enabled addons: storage-provisioner, default-storageclass + 🏄 Done! kubectl is now configured to use "minikube" cluster and "default" namespace by default + ``` + +2. Run the following commands to start installation: + + ```bash + kubectl apply -f https://github.com/kubesphere/ks-installer/releases/download/v3.2.1/kubesphere-installer.yaml + + kubectl apply -f https://github.com/kubesphere/ks-installer/releases/download/v3.2.1/cluster-configuration.yaml + ``` + +3. After KubeSphere is successfully installed, you can run the following command to view the installation logs: + + ```bash + kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app=ks-install -o jsonpath='{.items[0].metadata.name}') -f + ``` + +4. Use `kubectl get pod --all-namespaces` to see whether all Pods are running normally in relevant namespaces of KubeSphere. If they are, check the port (`30880` by default) of the console by running the following command: + + ```bash + kubectl get svc/ks-console -n kubesphere-system + ``` + +5. Make sure port `30880` is opened in your security group and access the web console through the NodePort (`IP:30880`) with the default account and password (`admin/P@88w0rd`). + +6. After logging in to the console, you can check the status of different components in **System Components**. You may need to wait for some components to be up and running if you want to use related services. + +## Enable Pluggable Components (Optional) + +This guide is used only for the minimal installation by default. For more information about how to enable other components in KubeSphere, see [Enable Pluggable Components](../../../pluggable-components/). + +## Code Demonstration + + diff --git a/content/en/docs/installing-on-minikube/prerequisites.md b/content/en/docs/installing-on-kubernetes/on-prem-kubernetes/prerequisites-for-installation-on-minikube.md similarity index 88% rename from content/en/docs/installing-on-minikube/prerequisites.md rename to content/en/docs/installing-on-kubernetes/on-prem-kubernetes/prerequisites-for-installation-on-minikube.md index 95b6400fd..d3b4cc931 100644 --- a/content/en/docs/installing-on-minikube/prerequisites.md +++ b/content/en/docs/installing-on-kubernetes/on-prem-kubernetes/prerequisites-for-installation-on-minikube.md @@ -1,8 +1,8 @@ --- -title: "Prerequisites" +title: "Prerequisites for Minikube" keywords: "KubeSphere, Minikube, Installation, Prerequisites" description: "Make sure your environment where an existing Minikube cluster runs meets the prerequisites before installation." -linkTitle: "Prerequisites" +linkTitle: "Prerequisites for Minikube" weight: 4120 --- @@ -47,7 +47,7 @@ weight: 4120 ``` -3. Make sure your Kubernetes version is compatible by running `kubectl version` in your minikube cluster node. The output may look as below: +3. Make sure your Kubectl version is compatible by running `kubectl version` in your minikube cluster node. The output may look as below: ```bash ❯ kubectl version @@ -67,6 +67,4 @@ Pay attention to the `Server Version` line. If `GitVersion` shows an older one, glusterfs (default) kubernetes.io/glusterfs 3d4h ``` -If your Kubernetes cluster environment meets all the requirements above, then you are ready to deploy KubeSphere on your existing Kubernetes cluster. - -For more information, see [Overview](../overview/). +If your Minikube cluster environment meets all the requirements above, then you are ready to deploy KubeSphere on your Minikube. diff --git a/content/en/docs/installing-on-minikube/uninstall-kubesphere-from-minikube.md b/content/en/docs/installing-on-kubernetes/on-prem-kubernetes/uninstall-kubesphere-from-minikube.md similarity index 98% rename from content/en/docs/installing-on-minikube/uninstall-kubesphere-from-minikube.md rename to content/en/docs/installing-on-kubernetes/on-prem-kubernetes/uninstall-kubesphere-from-minikube.md index 5849a572e..246db5ee4 100644 --- a/content/en/docs/installing-on-minikube/uninstall-kubesphere-from-minikube.md +++ b/content/en/docs/installing-on-kubernetes/on-prem-kubernetes/uninstall-kubesphere-from-minikube.md @@ -12,4 +12,4 @@ You can uninstall KubeSphere from your existing Minikube cluster by using [kubes Uninstalling will remove KubeSphere from your Minikube cluster. This operation is irreversible and does not have any backup. Please be cautious with this operation. -{{}} \ No newline at end of file +{{}} diff --git a/content/en/docs/installing-on-minikube/_index.md b/content/en/docs/installing-on-minikube/_index.md deleted file mode 100644 index d59afa1c1..000000000 --- a/content/en/docs/installing-on-minikube/_index.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: "Installing on Minikube" -description: "Demonstrate how to install KubeSphere on Minikube." -layout: "second" - -linkTitle: "Installing on Minikube" -weight: 3000 - -icon: "/images/docs/docs.svg" ---- \ No newline at end of file