diff --git a/content/en/docs/application-store/built-in-apps/minio-app.md b/content/en/docs/application-store/built-in-apps/minio-app.md index 6c5bb8328..4b00e505a 100644 --- a/content/en/docs/application-store/built-in-apps/minio-app.md +++ b/content/en/docs/application-store/built-in-apps/minio-app.md @@ -1,51 +1,82 @@ --- -title: "Minio App" +title: "Deploy MinIO on KubeSphere" keywords: 'Kubernetes, KubeSphere, Minio, app-store' -description: 'How to use built-in Minio Object Storage' - +description: 'How to deploy Minio on KubeSphere from the App Store of KubeSphere' +linkTitle: "Deploy MinIO on KubeSphere" weight: 2242 --- -MinIO object storage is designed for high performence and the S3 API. This guide will show you how to deploy Minio object storage with only a few steps. +[MinIO](https://min.io/) object storage is designed for high performance and the S3 API. It is ideal for large, private cloud environments with stringent security requirements and delivers mission-critical availability across a diverse range of workloads. + +This tutorial walks you through an example of deploying MinIO from the App Store of KubeSphere. ## Prerequisites -- You have enabled [KubeSphere App Store](../../pluggable-components/app-store) -- You have completed the tutorial in [Create Workspace, Project, Account and Role](../../quick-start/create-workspace-and-project/). Now switch to use `project-regular` account to log in and enter into `demo-peoject`. +- Please make sure you [enable the OpenPitrix system](../../../pluggable-components/app-store/). +- You need to create a workspace, a project, and a user account (`project-regular`) for this tutorial. The account needs to be a platform regular user and to be invited as the project operator with the `operator` role. In this tutorial, you log in as `project-regular` and work in the project `demo-project` in the workspace `demo-workspace`. For more information, see [Create Workspace, Project, Account and Role](../../../quick-start/create-workspace-and-project/). ## Hands-on Lab -### Common steps +### Step 1: Deploy MinIO from App Store -1. Choose Minio template `From App Store`. +1. On the **Overview** page of the project `demo-project`, click **App Store** in the top left corner. -![choose_minio_from_app_store](/images/docs/appstore/minio/choose_minio_from_app_store.png) + ![minio-app](/images/docs/appstore/built-in-apps/minio-app/minio-app.jpg) -2. Check app info and click `Deploy` button. +2. Find MinIO and click **Deploy** on the **App Info** page. -![deploy_minio](/images/docs/appstore/minio/deploy_minio.png) + ![minio-in-app-store](/images/docs/appstore/built-in-apps/minio-app/minio-in-app-store.jpg) -3. Select app version and deployment location, then go to **Next → Deploy** + ![deploy-minio](/images/docs/appstore/built-in-apps/minio-app/deploy-minio.jpg) -![deploy_minio_confirm](/images/docs/appstore/minio/deploy_minio_confirm.png) +3. Set a name and select an app version. Make sure MinIO is deployed in `demo-project` and click **Next**. -4. Wait for a few minutes, then you will see the application minio showing active on the application list. + ![minio-deploy](/images/docs/appstore/built-in-apps/minio-app/minio-deploy.jpg) -![minio_active](/images/docs/appstore/minio/minio_active.png) +4. In **App Config**, you can use the default configuration or customize the configuration by editing the YAML file directly. Click **Deploy** to continue. -5. Click into Minio application, and then enter into its service page. + ![deloy-minio-2](/images/docs/appstore/built-in-apps/minio-app/deloy-minio-2.jpg) -![View Minio Detail](/images/docs/appstore/minio/view_minio_service.png) +5. Wait until MinIO is up and running. -6. In this page, make sure its deployment and Pod are running, then click **More → Edit Internet Access**, and select **NodePort** in the dropdown list, click **OK** to save it. + ![minio-in-list](/images/docs/appstore/built-in-apps/minio-app/minio-in-list.jpg) -![Expose Minio Service](/images/docs/appstore/minio/expose_minio_service.png) +### Step 2: Access MinIO Browser -7.Go to **App Template → Configuration Files** and get accessKey and secretKey from `values.yaml`. +To access MinIO outside the cluster, you need to expose the app through NodePort first. -![Get Minio Access Key](/images/docs/appstore/minio/get_minio_access_key.png) +1. Go to **Services** and click the service name of MinIO. -8. In this step, we can access Minio object storage service using ${Node IP}:${NODEPORT}, e.g. http://192.168.18.152:30116/ with the access key and secret key we got previously to login. + ![minio-detail](/images/docs/appstore/built-in-apps/minio-app/minio-detail.jpg) -![Get Minio Access Key](/images/docs/appstore/minio/login_minio_console.png) +2. Click **More** and select **Edit Internet Access** from the drop-down menu. + ![edit-internet-access](/images/docs/appstore/built-in-apps/minio-app/edit-internet-access.jpg) + +3. Select **NodePort** for **Access Method** and click **OK**. For more information, see [Project Gateway](../../../project-administration/project-gateway/). + + ![nodeport](/images/docs/appstore/built-in-apps/minio-app/nodeport.jpg) + +4. Under **Service Ports**, you can see the port is exposed. + + ![port-exposed](/images/docs/appstore/built-in-apps/minio-app/port-exposed.jpg) + +5. To access the MinIO browser, you need `accessKey` and `secretKey`, which are specified in the configuration file of MinIO. Go to **App Templates** in **Applications**, click MinIO, and you can find the value of these two fields under the tab **Configuration Files**. + + ![template-list](/images/docs/appstore/built-in-apps/minio-app/template-list.jpg) + + ![config-file](/images/docs/appstore/built-in-apps/minio-app/config-file.jpg) + +6. Access the MinIO browser through `{$NodeIP}:{$Nodeport}` using `accessKey` and `secretKey`. + + ![minio-browser](/images/docs/appstore/built-in-apps/minio-app/minio-browser.jpg) + + ![minio-browser-interface](/images/docs/appstore/built-in-apps/minio-app/minio-browser-interface.jpg) + + {{< notice note >}} + + You may need to open the port in your security groups and configure related port forwarding rules depending on your where your Kubernetes cluster is deployed. + + {{}} + +7. For more information about MinIO, refer to [the official documentation of MinIO](https://docs.min.io/). \ No newline at end of file diff --git a/static/images/docs/appstore/built-in-apps/minio-app/config-file.jpg b/static/images/docs/appstore/built-in-apps/minio-app/config-file.jpg new file mode 100644 index 000000000..a47ca8d4a Binary files /dev/null and b/static/images/docs/appstore/built-in-apps/minio-app/config-file.jpg differ diff --git a/static/images/docs/appstore/built-in-apps/minio-app/deloy-minio-2.jpg b/static/images/docs/appstore/built-in-apps/minio-app/deloy-minio-2.jpg new file mode 100644 index 000000000..2f48c7989 Binary files /dev/null and b/static/images/docs/appstore/built-in-apps/minio-app/deloy-minio-2.jpg differ diff --git a/static/images/docs/appstore/built-in-apps/minio-app/deploy-minio.jpg b/static/images/docs/appstore/built-in-apps/minio-app/deploy-minio.jpg new file mode 100644 index 000000000..8ffd712f4 Binary files /dev/null and b/static/images/docs/appstore/built-in-apps/minio-app/deploy-minio.jpg differ diff --git a/static/images/docs/appstore/built-in-apps/minio-app/edit-internet-access.jpg b/static/images/docs/appstore/built-in-apps/minio-app/edit-internet-access.jpg new file mode 100644 index 000000000..5b1b944cb Binary files /dev/null and b/static/images/docs/appstore/built-in-apps/minio-app/edit-internet-access.jpg differ diff --git a/static/images/docs/appstore/built-in-apps/minio-app/minio-app.jpg b/static/images/docs/appstore/built-in-apps/minio-app/minio-app.jpg new file mode 100644 index 000000000..39e4070fc Binary files /dev/null and b/static/images/docs/appstore/built-in-apps/minio-app/minio-app.jpg differ diff --git a/static/images/docs/appstore/built-in-apps/minio-app/minio-browser-interface.jpg b/static/images/docs/appstore/built-in-apps/minio-app/minio-browser-interface.jpg new file mode 100644 index 000000000..a7f59cca0 Binary files /dev/null and b/static/images/docs/appstore/built-in-apps/minio-app/minio-browser-interface.jpg differ diff --git a/static/images/docs/appstore/built-in-apps/minio-app/minio-browser.jpg b/static/images/docs/appstore/built-in-apps/minio-app/minio-browser.jpg new file mode 100644 index 000000000..dab2ce44b Binary files /dev/null and b/static/images/docs/appstore/built-in-apps/minio-app/minio-browser.jpg differ diff --git a/static/images/docs/appstore/built-in-apps/minio-app/minio-deploy.jpg b/static/images/docs/appstore/built-in-apps/minio-app/minio-deploy.jpg new file mode 100644 index 000000000..c19e1e031 Binary files /dev/null and b/static/images/docs/appstore/built-in-apps/minio-app/minio-deploy.jpg differ diff --git a/static/images/docs/appstore/built-in-apps/minio-app/minio-detail.jpg b/static/images/docs/appstore/built-in-apps/minio-app/minio-detail.jpg new file mode 100644 index 000000000..2cea2c58a Binary files /dev/null and b/static/images/docs/appstore/built-in-apps/minio-app/minio-detail.jpg differ diff --git a/static/images/docs/appstore/built-in-apps/minio-app/minio-in-app-store.jpg b/static/images/docs/appstore/built-in-apps/minio-app/minio-in-app-store.jpg new file mode 100644 index 000000000..4b341468c Binary files /dev/null and b/static/images/docs/appstore/built-in-apps/minio-app/minio-in-app-store.jpg differ diff --git a/static/images/docs/appstore/built-in-apps/minio-app/minio-in-list.jpg b/static/images/docs/appstore/built-in-apps/minio-app/minio-in-list.jpg new file mode 100644 index 000000000..de6fcbae6 Binary files /dev/null and b/static/images/docs/appstore/built-in-apps/minio-app/minio-in-list.jpg differ diff --git a/static/images/docs/appstore/built-in-apps/minio-app/nodeport.jpg b/static/images/docs/appstore/built-in-apps/minio-app/nodeport.jpg new file mode 100644 index 000000000..156786690 Binary files /dev/null and b/static/images/docs/appstore/built-in-apps/minio-app/nodeport.jpg differ diff --git a/static/images/docs/appstore/built-in-apps/minio-app/port-exposed.jpg b/static/images/docs/appstore/built-in-apps/minio-app/port-exposed.jpg new file mode 100644 index 000000000..d8c5e75fa Binary files /dev/null and b/static/images/docs/appstore/built-in-apps/minio-app/port-exposed.jpg differ diff --git a/static/images/docs/appstore/built-in-apps/minio-app/template-list.jpg b/static/images/docs/appstore/built-in-apps/minio-app/template-list.jpg new file mode 100644 index 000000000..ca898aa8f Binary files /dev/null and b/static/images/docs/appstore/built-in-apps/minio-app/template-list.jpg differ diff --git a/static/images/docs/appstore/minio/choose_minio_from_app_store.png b/static/images/docs/appstore/minio/choose_minio_from_app_store.png deleted file mode 100644 index d67ffcad6..000000000 Binary files a/static/images/docs/appstore/minio/choose_minio_from_app_store.png and /dev/null differ diff --git a/static/images/docs/appstore/minio/deploy_minio.png b/static/images/docs/appstore/minio/deploy_minio.png deleted file mode 100644 index c509865ab..000000000 Binary files a/static/images/docs/appstore/minio/deploy_minio.png and /dev/null differ diff --git a/static/images/docs/appstore/minio/deploy_minio_confirm.png b/static/images/docs/appstore/minio/deploy_minio_confirm.png deleted file mode 100644 index 00727a11a..000000000 Binary files a/static/images/docs/appstore/minio/deploy_minio_confirm.png and /dev/null differ diff --git a/static/images/docs/appstore/minio/expose_minio_service.png b/static/images/docs/appstore/minio/expose_minio_service.png deleted file mode 100644 index 1771675c4..000000000 Binary files a/static/images/docs/appstore/minio/expose_minio_service.png and /dev/null differ diff --git a/static/images/docs/appstore/minio/get_minio_access_key.png b/static/images/docs/appstore/minio/get_minio_access_key.png deleted file mode 100644 index e4638c92f..000000000 Binary files a/static/images/docs/appstore/minio/get_minio_access_key.png and /dev/null differ diff --git a/static/images/docs/appstore/minio/login_minio_console.png b/static/images/docs/appstore/minio/login_minio_console.png deleted file mode 100644 index e0c955599..000000000 Binary files a/static/images/docs/appstore/minio/login_minio_console.png and /dev/null differ diff --git a/static/images/docs/appstore/minio/minio_active.png b/static/images/docs/appstore/minio/minio_active.png deleted file mode 100644 index 8401756a2..000000000 Binary files a/static/images/docs/appstore/minio/minio_active.png and /dev/null differ diff --git a/static/images/docs/appstore/minio/view_minio_service.png b/static/images/docs/appstore/minio/view_minio_service.png deleted file mode 100644 index 0cba9d2b1..000000000 Binary files a/static/images/docs/appstore/minio/view_minio_service.png and /dev/null differ