3. Add Deployments and Services with the Istio Sidecar

Prerequisite: To enable Istio for a workload, the cluster and namespace must have the Istio app installed.

Enabling Istio in a namespace only enables automatic sidecar injection for new workloads. To enable the Envoy sidecar for existing workloads, you need to enable it manually for each workload.

To inject the Istio sidecar on an existing workload in the namespace,

  1. In the upper left corner, click ☰ > Cluster Management.
  2. On the Clusters page, go to the cluster where you want to see the visualizations and click Explore.
  3. Click Workload.
  4. Go to the workload where you want to inject the Istio sidecar and click ⋮ > Redeploy. When the workload is redeployed, it will have the Envoy sidecar automatically injected.

Wait a few minutes for the workload to upgrade to have the istio sidecar. Click it and go to the Containers section. You should be able to see istio-proxy alongside your original workload. This means the Istio sidecar is enabled for the workload. Istio is doing all the wiring for the sidecar envoy. Now Istio can do all the features automatically if you enable them in the yaml.

Add Deployments and Services

There are a few ways to add new Deployments in your namespace:

  1. Click ☰ > Cluster Management.
  2. Go to the cluster that you created and click Explore.
  3. Click Workload.
  4. Click Create.
  5. Click Deployment.
  6. Fill out the form, or Edit as Yaml.
  7. Click Create.

To add a Service to your namespace:

  1. Click ☰ > Cluster Management.
  2. Go to the cluster that you created and click Explore.
  3. Click Service Discovery > Services.
  4. Click Create.
  5. Select the type of service that you want.
  6. Fill out the form, or Edit as Yaml.
  7. Click Create

You can also create deployments and services using the kubectl shell

  1. Run kubectl create -f <name of service/deployment file>.yaml if your file is stored locally in the cluster
  2. Or run cat<< EOF | kubectl apply -f -, paste the file contents into the terminal, then run EOF to complete the command.

Example Deployments and Services

Next we add the Kubernetes resources for the sample deployments and services for the BookInfo app in Istio’s documentation.

  1. Click ☰ > Cluster Management.
  2. Go to the cluster that you created and click Explore.
  3. In the top navigation bar, open the kubectl shell.
  4. Run cat<< EOF | kubectl apply -f -
  5. Copy the below resources into the the shell.
  6. Run EOF

This will set up the following sample resources from Istio’s example BookInfo app:

Details service and deployment:

  • A details Service
  • A ServiceAccount for bookinfo-details
  • A details-v1 Deployment

Ratings service and deployment:

  • A ratings Service
  • A ServiceAccount for bookinfo-ratings
  • A ratings-v1 Deployment

Reviews service and deployments (three versions):

  • A reviews Service
  • A ServiceAccount for bookinfo-reviews
  • A reviews-v1 Deployment
  • A reviews-v2 Deployment
  • A reviews-v3 Deployment

Productpage service and deployment:

This is the main page of the app, which will be visible from a web browser. The other services will be called from this page.

  • A productpage service
  • A ServiceAccount for bookinfo-productpage
  • A productpage-v1 Deployment

Resource YAML

  1. # Copyright 2017 Istio Authors
  2. #
  3. #   Licensed under the Apache License, Version 2.0 (the "License");
  4. #   you may not use this file except in compliance with the License.
  5. #   You may obtain a copy of the License at
  6. #
  7. #       http://www.apache.org/licenses/LICENSE-2.0
  8. #
  9. #   Unless required by applicable law or agreed to in writing, software
  10. #   distributed under the License is distributed on an "AS IS" BASIS,
  11. #   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12. #   See the License for the specific language governing permissions and
  13. #   limitations under the License.
  15. ##################################################################################################
  16. # Details service
  17. ##################################################################################################
  18. apiVersion: v1
  19. kind: Service
  20. metadata:
  21.   name: details
  22.   labels:
  23.     app: details
  24.     service: details
  25. spec:
  26.   ports:
  27.   - port: 9080
  28.     name: http
  29.   selector:
  30.     app: details
  31. ---
  32. apiVersion: v1
  33. kind: ServiceAccount
  34. metadata:
  35.   name: bookinfo-details
  36. ---
  37. apiVersion: apps/v1
  38. kind: Deployment
  39. metadata:
  40.   name: details-v1
  41.   labels:
  42.     app: details
  43.     version: v1
  44. spec:
  45.   replicas: 1
  46.   selector:
  47.     matchLabels:
  48.       app: details
  49.       version: v1
  50.   template:
  51.     metadata:
  52.       labels:
  53.         app: details
  54.         version: v1
  55.     spec:
  56.       serviceAccountName: bookinfo-details
  57.       containers:
  58.       - name: details
  59.         image: docker.io/istio/examples-bookinfo-details-v1:1.15.0
  60.         imagePullPolicy: IfNotPresent
  61.         ports:
  62.         - containerPort: 9080
  63. ---
  64. ##################################################################################################
  65. # Ratings service
  66. ##################################################################################################
  67. apiVersion: v1
  68. kind: Service
  69. metadata:
  70.   name: ratings
  71.   labels:
  72.     app: ratings
  73.     service: ratings
  74. spec:
  75.   ports:
  76.   - port: 9080
  77.     name: http
  78.   selector:
  79.     app: ratings
  80. ---
  81. apiVersion: v1
  82. kind: ServiceAccount
  83. metadata:
  84.   name: bookinfo-ratings
  85. ---
  86. apiVersion: apps/v1
  87. kind: Deployment
  88. metadata:
  89.   name: ratings-v1
  90.   labels:
  91.     app: ratings
  92.     version: v1
  93. spec:
  94.   replicas: 1
  95.   selector:
  96.     matchLabels:
  97.       app: ratings
  98.       version: v1
  99.   template:
  100.     metadata:
  101.       labels:
  102.         app: ratings
  103.         version: v1
  104.     spec:
  105.       serviceAccountName: bookinfo-ratings
  106.       containers:
  107.       - name: ratings
  108.         image: docker.io/istio/examples-bookinfo-ratings-v1:1.15.0
  109.         imagePullPolicy: IfNotPresent
  110.         ports:
  111.         - containerPort: 9080
  112. ---
  113. ##################################################################################################
  114. # Reviews service
  115. ##################################################################################################
  116. apiVersion: v1
  117. kind: Service
  118. metadata:
  119.   name: reviews
  120.   labels:
  121.     app: reviews
  122.     service: reviews
  123. spec:
  124.   ports:
  125.   - port: 9080
  126.     name: http
  127.   selector:
  128.     app: reviews
  129. ---
  130. apiVersion: v1
  131. kind: ServiceAccount
  132. metadata:
  133.   name: bookinfo-reviews
  134. ---
  135. apiVersion: apps/v1
  136. kind: Deployment
  137. metadata:
  138.   name: reviews-v1
  139.   labels:
  140.     app: reviews
  141.     version: v1
  142. spec:
  143.   replicas: 1
  144.   selector:
  145.     matchLabels:
  146.       app: reviews
  147.       version: v1
  148.   template:
  149.     metadata:
  150.       labels:
  151.         app: reviews
  152.         version: v1
  153.     spec:
  154.       serviceAccountName: bookinfo-reviews
  155.       containers:
  156.       - name: reviews
  157.         image: docker.io/istio/examples-bookinfo-reviews-v1:1.15.0
  158.         imagePullPolicy: IfNotPresent
  159.         ports:
  160.         - containerPort: 9080
  161. ---
  162. apiVersion: apps/v1
  163. kind: Deployment
  164. metadata:
  165.   name: reviews-v2
  166.   labels:
  167.     app: reviews
  168.     version: v2
  169. spec:
  170.   replicas: 1
  171.   selector:
  172.     matchLabels:
  173.       app: reviews
  174.       version: v2
  175.   template:
  176.     metadata:
  177.       labels:
  178.         app: reviews
  179.         version: v2
  180.     spec:
  181.       serviceAccountName: bookinfo-reviews
  182.       containers:
  183.       - name: reviews
  184.         image: docker.io/istio/examples-bookinfo-reviews-v2:1.15.0
  185.         imagePullPolicy: IfNotPresent
  186.         ports:
  187.         - containerPort: 9080
  188. ---
  189. apiVersion: apps/v1
  190. kind: Deployment
  191. metadata:
  192.   name: reviews-v3
  193.   labels:
  194.     app: reviews
  195.     version: v3
  196. spec:
  197.   replicas: 1
  198.   selector:
  199.     matchLabels:
  200.       app: reviews
  201.       version: v3
  202.   template:
  203.     metadata:
  204.       labels:
  205.         app: reviews
  206.         version: v3
  207.     spec:
  208.       serviceAccountName: bookinfo-reviews
  209.       containers:
  210.       - name: reviews
  211.         image: docker.io/istio/examples-bookinfo-reviews-v3:1.15.0
  212.         imagePullPolicy: IfNotPresent
  213.         ports:
  214.         - containerPort: 9080
  215. ---
  216. ##################################################################################################
  217. # Productpage services
  218. ##################################################################################################
  219. apiVersion: v1
  220. kind: Service
  221. metadata:
  222.   name: productpage
  223.   labels:
  224.     app: productpage
  225.     service: productpage
  226. spec:
  227.   ports:
  228.   - port: 9080
  229.     name: http
  230.   selector:
  231.     app: productpage
  232. ---
  233. apiVersion: v1
  234. kind: ServiceAccount
  235. metadata:
  236.   name: bookinfo-productpage
  237. ---
  238. apiVersion: apps/v1
  239. kind: Deployment
  240. metadata:
  241.   name: productpage-v1
  242.   labels:
  243.     app: productpage
  244.     version: v1
  245. spec:
  246.   replicas: 1
  247.   selector:
  248.     matchLabels:
  249.       app: productpage
  250.       version: v1
  251.   template:
  252.     metadata:
  253.       labels:
  254.         app: productpage
  255.         version: v1
  256.     spec:
  257.       serviceAccountName: bookinfo-productpage
  258.       containers:
  259.       - name: productpage
  260.         image: docker.io/istio/examples-bookinfo-productpage-v1:1.15.0
  261.         imagePullPolicy: IfNotPresent
  262.         ports:
  263.         - containerPort: 9080
  264. ---

Next: Set up the Istio Gateway