Word3 (#900)
* worddd Signed-off-by: Sherlock113 <sherlockxu@yunify.com> * update wordpress quickstart Signed-off-by: Sherlock113 <sherlockxu@yunify.com>
Sherlock113
GitHub
|
|
@ -2,7 +2,6 @@
|
|||
title: "Compose and Deploy WordPress"
|
||||
keywords: 'KubeSphere, Kubernetes, app, WordPress'
|
||||
description: 'Compose and deploy Wordpress.'
|
||||
|
||||
linkTitle: "Compose and Deploy WordPress"
|
||||
weight: 2500
|
||||
---
|
||||
|
|
@ -11,7 +10,7 @@ weight: 2500
|
|||
|
||||
WordPress is a free and open-source content management system written in PHP, allowing users to build their own websites. A complete WordPress application includes the following Kubernetes objects with MySQL serving as the backend database.
|
||||
|
||||
|
||||
|
||||
|
||||
## Objective
|
||||
|
||||
|
|
@ -19,7 +18,7 @@ This tutorial demonstrates how to create an application (WordPress as an example
|
|||
|
||||
## Prerequisites
|
||||
|
||||
An account `project-regular` is needed with the role `operator` assigned in one of your projects (the user has been invited to the project). For more information, see [Create Workspaces, Projects, Accounts and Roles](../create-workspace-and-project/).
|
||||
An account `project-regular` is needed with the role of `operator` assigned in one of your projects (the user has been invited to the project). For more information, see [Create Workspaces, Projects, Accounts and Roles](../create-workspace-and-project/).
|
||||
|
||||
## Estimated Time
|
||||
|
||||
|
|
@ -27,173 +26,174 @@ About 15 minutes.
|
|||
|
||||
## Hands-on Lab
|
||||
|
||||
### Task 1: Create Secrets
|
||||
### Step 1: Create Secrets
|
||||
|
||||
#### Create a MySQL Secret
|
||||
|
||||
The environment variable `WORDPRESS_DB_PASSWORD` is the password to connect to the database in WordPress. In this step, you need to create a Secret to store the environment variable that will be used in MySQL pod template.
|
||||
The environment variable `WORDPRESS_DB_PASSWORD` is the password to connect to the database in WordPress. In this step, you need to create a Secret to store the environment variable that will be used in the MySQL Pod template.
|
||||
|
||||
1. Log in to KubeSphere console using the account `project-regular`. Go to the detailed page of `demo-project` and navigate to **Configurations**. In **Secrets**, click **Create** on the right.
|
||||
1. Log in to the KubeSphere console using the account `project-regular`. Go to the detail page of `demo-project` and navigate to **Configurations**. In **Secrets**, click **Create** on the right.
|
||||
|
||||
|
||||
|
||||
|
||||
2. Enter the basic information (e.g. name it `mysql-secret`) and click **Next**. In the next page, select **Default** for **Type** and click **Add Data** to add a key-value pair. Input the Key (`MYSQL_ROOT_PASSWORD`) and Value (`123456`) as below and click `√` in the bottom-right corner to confirm. When you finish, click **Create** to continue.
|
||||
2. Enter the basic information (e.g. name it `mysql-secret`) and click **Next**. On the next page, select **Default** for **Type** and click **Add Data** to add a key-value pair. Input the Key (`MYSQL_ROOT_PASSWORD`) and Value (`123456`) as below and click **√** in the bottom-right corner to confirm. When you finish, click **Create** to continue.
|
||||
|
||||
|
||||
|
||||
|
||||
#### Create a WordPress Secret
|
||||
|
||||
Follow the same steps above to create a WordPress secret `wordpress-secret` with the key `WORDPRESS_DB_PASSWORD` and value `123456`. Secrets created display in the list as below:
|
||||
Follow the same steps above to create a WordPress Secret `wordpress-secret` with the key `WORDPRESS_DB_PASSWORD` and value `123456`. Secrets created display in the list as below:
|
||||
|
||||
|
||||
|
||||
|
||||
### Task 2: Create a Volume
|
||||
### Step 2: Create a volume
|
||||
|
||||
1. Go to **Volumes** under **Storage** and click **Create**.
|
||||
|
||||
|
||||
|
||||
|
||||
2. Enter the basic information of the volume (e.g. name it `wordpress-pvc`) and click **Next**.
|
||||
|
||||
3. In **Volume Settings**, you need to choose an available **Storage Class**, and set **Access Mode** and **Volume Capacity**. You can use the default value directly as shown below. Click **Next** to continue.
|
||||
|
||||
|
||||
|
||||
|
||||
4. For **Advanced Settings**, you do not need to add extra information for this task and click **Create** to finish.
|
||||
4. For **Advanced Settings**, you do not need to add extra information for this step and click **Create** to finish.
|
||||
|
||||
### Task 3: Create an Application
|
||||
### Step 3: Create an application
|
||||
|
||||
#### Add MySQL backend component
|
||||
#### Add MySQL backend components
|
||||
|
||||
1. Navigate to **Applications** under **Application Workloads**, select **Composing App** and click **Create Composing Application**.
|
||||
|
||||
|
||||
|
||||
|
||||
2. Enter the basic information (e.g. input `wordpress` for Application Name) and click **Next**.
|
||||
|
||||
|
||||
|
||||
|
||||
3. In **Components**, click **Add Service** to set a component in the app.
|
||||
|
||||
|
||||
|
||||
|
||||
4. Define a service type for the component. Select **Stateful Service** here.
|
||||
|
||||
5. Enter the name for the stateful service (e.g. **mysql**) and click **Next**.
|
||||
|
||||
|
||||
|
||||
|
||||
6. In **Container Image**, click **Add Container Image**.
|
||||
|
||||
|
||||
|
||||
|
||||
7. Enter `mysql:5.6` in the search box, press **Enter** and click **Use Default Ports**. After that, do not click `√` in the bottom-right corner as the setting is not finished yet.
|
||||
7. Enter `mysql:5.6` in the search box, press **Enter** and click **Use Default Ports**. After that, do not click **√** in the bottom-right corner as the setting is not finished yet.
|
||||
|
||||
|
||||
|
||||
|
||||
{{< notice note >}}
|
||||
{{< notice note >}}
|
||||
|
||||
In **Advanced Settings**, make sure the memory limit is no less than 1000 Mi or MySQL may fail to start due to a lack of memory.
|
||||
|
||||
{{</ notice >}}
|
||||
|
||||
8. Scroll down to **Environment Variables** and click **Use ConfigMap or Secret**. Input the name `MYSQL_ROOT_PASSWORD` and choose the resource `mysql-secret` and the key `MYSQL_ROOT_PASSWORD` created in the previous step. Click `√` after you finish and **Next** to continue.
|
||||
8. Scroll down to **Environment Variables** and click **Use ConfigMap or Secret**. Input the name `MYSQL_ROOT_PASSWORD` and choose the resource `mysql-secret` and the key `MYSQL_ROOT_PASSWORD` created in the previous step. Click **√** after you finish and **Next** to continue.
|
||||
|
||||
|
||||
|
||||
|
||||
9. Select **Add Volume Template** in **Mount Volumes**. Input the value of **Volume Name** (`mysql`) and **Mount Path** (mode: `ReadAndWrite`, path: `/var/lib/mysql`) as below:
|
||||
|
||||
|
||||
|
||||
|
||||
Click `√` after you finish and click **Next** to continue.
|
||||
Click **√** after you finish and click **Next** to continue.
|
||||
|
||||
10. In **Advanced Settings**, you can click **Add** directly or select other options based on your needs.
|
||||
|
||||
|
||||
|
||||
|
||||
11. At this point, the MySQL component has beed added as shown below:
|
||||
11. The MySQL component has beed added as shown below:
|
||||
|
||||
|
||||
|
||||
|
||||
#### Add WordPress frontend component
|
||||
#### Add the WordPress frontend component
|
||||
|
||||
12. Click **Add Service** again and select **Stateless Service** this time. Enter the name `wordpress` and click Next.
|
||||
|
||||
|
||||
|
||||
|
||||
13. Similar to the step above, click **Add Container Image**, enter `wordpress:4.8-apache` in the search box, press **Enter** and click **Use Default Ports**.
|
||||
|
||||
|
||||
|
||||
|
||||
14. Scroll down to **Environment Variables** and click **Use ConfigMap or Secret**. Two environment variables need to be added here. Enter the values according to the screenshot below.
|
||||
|
||||
- For `WORDPRESS_DB_PASSWORD`, choose `wordpress-secret` and `WORDPRESS_DB_PASSWORD` created in Task 1.
|
||||
- Click **Add Environment Variable**, and enter `WORDPRESS_DB_HOST` and `mysql` for the key and value.
|
||||
- For `WORDPRESS_DB_PASSWORD`, choose `wordpress-secret` and `WORDPRESS_DB_PASSWORD` created in Task 1.
|
||||
|
||||
{{< notice warning >}}
|
||||
- Click **Add Environment Variable**, and enter `WORDPRESS_DB_HOST` and `mysql` for the key and value.
|
||||
|
||||
{{< notice warning >}}
|
||||
|
||||
For the second environment variable added here, the value must be exactly the same as the name you set for MySQL in step 5. Otherwise, Wordpress cannot connect to the corresponding database of MySQL.
|
||||
|
||||
{{</ notice >}}
|
||||
|
||||
|
||||
|
||||
Click `√` to save it and **Next** to continue.
|
||||
|
||||
|
||||
Click **√** to save it and **Next** to continue.
|
||||
|
||||
15. In **Mount Volumes**, click **Add Volume** and select **Choose an existing volume**.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
16. Select `wordpress-pvc` created in the previous step, set the mode as `ReadAndWrite`, and input `/var/www/html` as its mount path. Click **√** to save it and **Next** to continue.
|
||||
|
||||
|
||||
|
||||
16. Select `wordpress-pvc` created in the previous step, set the mode as `ReadAndWrite`, and input `/var/www/html` as its mount path. Click `√` to save it and **Next** to continue.
|
||||
|
||||
|
||||
|
||||
|
||||
17. In **Advanced Settings**, you can click **Add** directly or select other options based on your needs.
|
||||
|
||||
|
||||
|
||||
|
||||
18. The frontend component is also set now. Click **Next** to continue.
|
||||
18. The frontend component is also set now. Click **Next** to continue.
|
||||
|
||||
|
||||
|
||||
|
||||
19. You can set route rules (Ingress) here or click **Create** directly.
|
||||
|
||||
|
||||
|
||||
|
||||
20. The app will display in the list below after you create it.
|
||||
|
||||
|
||||
|
||||
|
||||
### Task 4: Verify the Resources
|
||||
### Step 4: Verify resources
|
||||
|
||||
In **Workloads**, check the status of `wordpress-v1` and `mysql-v1` in **Deployments** and **StatefulSets** respectively. If they are running as shown in the image below, it means WordPress has been created successfully.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### Task 5: Access WordPress through NodePort
|
||||
### Step 5: Access WordPress through NodePort
|
||||
|
||||
1. To access the service outside the cluster, navigate to **Services** first. Click the three dots on the right of `wordpress` and select **Edit Internet Access**.
|
||||
1. To access the Service outside the cluster, navigate to **Services** first. Click the three dots on the right of `wordpress` and select **Edit Internet Access**.
|
||||
|
||||
|
||||
|
||||
|
||||
2. Select `NodePort` for **Access Method** and click **OK**.
|
||||
|
||||
|
||||
|
||||
|
||||
3. Click the service and you can see the port exposed.
|
||||
3. Click the Service and you can see the port is exposed.
|
||||
|
||||
|
||||
|
||||
|
||||
4. Access this application via `{Node IP}:{NodePort}` and you can see an image as below:
|
||||
4. Access this application at `{Node IP}:{NodePort}` and you can see an image as below:
|
||||
|
||||
|
||||
|
||||
|
||||
{{< notice note >}}
|
||||
{{< notice note >}}
|
||||
|
||||
Make sure the port is opened in your security groups before you access the service.
|
||||
Make sure the port is opened in your security groups before you access the Service.
|
||||
|
||||
{{</ notice >}}
|
||||
|
After Width: | Height: | Size: 144 KiB |
|
After Width: | Height: | Size: 43 KiB |
|
After Width: | Height: | Size: 118 KiB |
|
After Width: | Height: | Size: 59 KiB |
|
After Width: | Height: | Size: 71 KiB |
|
After Width: | Height: | Size: 80 KiB |
|
After Width: | Height: | Size: 78 KiB |
|
After Width: | Height: | Size: 135 KiB |
|
After Width: | Height: | Size: 97 KiB |
|
After Width: | Height: | Size: 77 KiB |
|
After Width: | Height: | Size: 64 KiB |
|
After Width: | Height: | Size: 128 KiB |
|
After Width: | Height: | Size: 117 KiB |
|
After Width: | Height: | Size: 107 KiB |
|
After Width: | Height: | Size: 112 KiB |
|
After Width: | Height: | Size: 137 KiB |
|
After Width: | Height: | Size: 128 KiB |
|
After Width: | Height: | Size: 125 KiB |
|
After Width: | Height: | Size: 56 KiB |
|
After Width: | Height: | Size: 53 KiB |
|
After Width: | Height: | Size: 81 KiB |
|
After Width: | Height: | Size: 44 KiB |
|
After Width: | Height: | Size: 112 KiB |
|
After Width: | Height: | Size: 101 KiB |
|
After Width: | Height: | Size: 87 KiB |
|
After Width: | Height: | Size: 136 KiB |
|
After Width: | Height: | Size: 81 KiB |
|
After Width: | Height: | Size: 287 KiB |
|
After Width: | Height: | Size: 101 KiB |
|
After Width: | Height: | Size: 115 KiB |
|
After Width: | Height: | Size: 72 KiB |
|
After Width: | Height: | Size: 111 KiB |