summaryrefslogtreecommitdiffhomepage
path: root/g3doc/user_guide/tutorials/kubernetes.md
blob: d2a94b1b7bd186c7f8a12ae4e575f9e44c804489 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
# WordPress with Kubernetes

This page shows you how to deploy a sample [WordPress][wordpress] site using
[GKE Sandbox][gke-sandbox].

### Before you begin

Take the following steps to enable the Kubernetes Engine API:

1.  Visit the [Kubernetes Engine page][project-selector] in the Google Cloud
    Platform Console.
1.  Create or select a project.

### Creating a node pool with gVisor enabled

Create a node pool inside your cluster with option `--sandbox type=gvisor` added
to the command, like below:

```bash
gcloud beta container node-pools create sandbox-pool --cluster=${CLUSTER_NAME} --image-type=cos_containerd --sandbox type=gvisor
```

If you prefer to use the console, select your cluster and select the **ADD NODE
POOL** button:

![+ ADD NODE POOL](./node-pool-button.png)

Then select the **Image type** with **Containerd** and select **Enable sandbox
with gVisor** option. Select other options as you like:

![+ NODE POOL](./add-node-pool.png)

### Check that gVisor is enabled

The gvisor RuntimeClass is instantiated during node creation. You can check for
the existence of the gvisor RuntimeClass using the following command:

```bash
kubectl get runtimeclasses
```

### Wordpress deployment

Now, let's deploy a WordPress site using GKE Sandbox. WordPress site requires
two pods: web server in the frontend, MySQL database in the backend. Both
applications use PersistentVolumes to store the site data data. In addition,
they use secret store to share MySQL password between them.

First, let's download the deployment configuration files to add the runtime
class annotation to them:

```bash
curl -LO https://k8s.io/examples/application/wordpress/wordpress-deployment.yaml
curl -LO https://k8s.io/examples/application/wordpress/mysql-deployment.yaml
```

Add a **spec.template.spec.runtimeClassName** set to **gvisor** to both files,
as shown below:

**wordpress-deployment.yaml:** ```yaml apiVersion: v1 kind: Service metadata:
name: wordpress labels: app: wordpress spec: ports: - port: 80 selector: app:
wordpress tier: frontend

## type: LoadBalancer

apiVersion: v1 kind: PersistentVolumeClaim metadata: name: wp-pv-claim labels:
app: wordpress spec: accessModes: - ReadWriteOnce resources: requests:

## storage: 20Gi

apiVersion: apps/v1 kind: Deployment metadata: name: wordpress labels: app:
wordpress spec: selector: matchLabels: app: wordpress tier: frontend strategy:
type: Recreate template: metadata: labels: app: wordpress tier: frontend spec:
runtimeClassName: gvisor # ADD THIS LINE containers: - image:
wordpress:4.8-apache name: wordpress env: - name: WORDPRESS_DB_HOST value:
wordpress-mysql - name: WORDPRESS_DB_PASSWORD valueFrom: secretKeyRef: name:
mysql-pass key: password ports: - containerPort: 80 name: wordpress
volumeMounts: - name: wordpress-persistent-storage mountPath: /var/www/html
volumes: - name: wordpress-persistent-storage persistentVolumeClaim: claimName:
wp-pv-claim ```

**mysql-deployment.yaml:** ```yaml apiVersion: v1 kind: Service metadata: name:
wordpress-mysql labels: app: wordpress spec: ports: - port: 3306 selector: app:
wordpress tier: mysql

## clusterIP: None

apiVersion: v1 kind: PersistentVolumeClaim metadata: name: mysql-pv-claim
labels: app: wordpress spec: accessModes: - ReadWriteOnce resources: requests:

## storage: 20Gi

apiVersion: apps/v1 kind: Deployment metadata: name: wordpress-mysql labels:
app: wordpress spec: selector: matchLabels: app: wordpress tier: mysql strategy:
type: Recreate template: metadata: labels: app: wordpress tier: mysql spec:
runtimeClassName: gvisor # ADD THIS LINE containers: - image: mysql:5.6 name:
mysql env: - name: MYSQL_ROOT_PASSWORD valueFrom: secretKeyRef: name: mysql-pass
key: password ports: - containerPort: 3306 name: mysql volumeMounts: - name:
mysql-persistent-storage mountPath: /var/lib/mysql volumes: - name:
mysql-persistent-storage persistentVolumeClaim: claimName: mysql-pv-claim ```

Note that apart from `runtimeClassName: gvisor`, nothing else about the
Deployment has is changed.

You are now ready to deploy the entire application. Just create a secret to
store MySQL's password and *apply* both deployments:

```bash
kubectl create secret generic mysql-pass --from-literal=password=${YOUR_SECRET_PASSWORD_HERE?}
kubectl apply -f mysql-deployment.yaml
kubectl apply -f wordpress-deployment.yaml
```

Wait for the deployments to be ready and an external IP to be assigned to the
Wordpress service:

```bash
watch kubectl get service wordpress
```

Now, copy the service `EXTERNAL-IP` from above to your favorite browser to view
and configure your new WordPress site.

Congratulations! You have just deployed a WordPress site using GKE Sandbox.

### What's next

To learn more about GKE Sandbox and how to run your deployment securely, take a
look at the [documentation][gke-sandbox-docs].

[gke-sandbox-docs]: https://cloud.google.com/kubernetes-engine/docs/how-to/sandbox-pods
[gke-sandbox]: https://cloud.google.com/kubernetes-engine/sandbox/
[project-selector]: https://console.cloud.google.com/projectselector/kubernetes
[wordpress]: https://wordpress.com/