Skip to content

Commit bfe2615

Browse files
authored
Merge pull request #31724 from JStickler/OSSMDOC-273
OSSMDOC-273: Adding bookinfo install output.
2 parents dd5ee77 + 836421d commit bfe2615

File tree

3 files changed

+68
-9
lines changed

3 files changed

+68
-9
lines changed

modules/ossm-tutorial-bookinfo-adding-destination-rules.adoc

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,11 +19,21 @@ Before you can use the Bookinfo application, you must first add default destinat
1919
----
2020
$ oc apply -n bookinfo -f https://raw.githubusercontent.com/Maistra/istio/maistra-{MaistraVersion}/samples/bookinfo/networking/destination-rule-all.yaml
2121
----
22-
22+
+
2323
** If you enabled mutual TLS:
2424
+
2525

2626
[source,bash,subs="attributes"]
2727
----
2828
$ oc apply -n bookinfo -f https://raw.githubusercontent.com/Maistra/istio/maistra-{MaistraVersion}/samples/bookinfo/networking/destination-rule-all-mtls.yaml
2929
----
30+
+
31+
You should see output similar to the following:
32+
+
33+
[source,terminal]
34+
----
35+
destinationrule.networking.istio.io/productpage created
36+
destinationrule.networking.istio.io/reviews created
37+
destinationrule.networking.istio.io/ratings created
38+
destinationrule.networking.istio.io/details created
39+
----

modules/ossm-tutorial-bookinfo-install.adoc

Lines changed: 41 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ This PROCEDURE module included in the following assemblies:
77
[id="ossm-tutorial-bookinfo-install_{context}"]
88
= Installing the Bookinfo application
99

10-
This tutorial walks you through how to create a Bookinfo project, deploying the Bookinfo application, and run Bookinfo on {product-title} with {ProductShortName} {ProductVersion}.
10+
This tutorial walks you through how to create a sample application by creating a project, deploying the Bookinfo application to that project, and viewing the running application in {ProductShortName}.
1111

1212
.Prerequisites:
1313

@@ -74,23 +74,46 @@ spec:
7474
$ oc create -n istio-system -f servicemeshmemberroll-default.yaml
7575
----
7676
+
77-
. Run the following command to verify the `ServiceMeshMemberRoll` was created successfully.
77+
. Run the following command to verify the `ServiceMeshMemberRoll` was created successfully.
7878
+
7979
[source,terminal]
8080
----
8181
$ oc get smmr -n istio-system
8282
----
8383
+
8484
The installation has finished successfully when the `STATUS` column is `Configured`.
85-
85+
+
86+
[source,terminal]
87+
----
88+
NAME READY STATUS AGE
89+
default 1/1 Configured 2m27s
90+
----
8691
. From the CLI, deploy the Bookinfo application in the _`bookinfo`_ project by applying the `bookinfo.yaml` file:
8792
+
8893
[source,bash,subs="attributes"]
8994
----
9095
$ oc apply -n bookinfo -f https://raw.githubusercontent.com/Maistra/istio/maistra-{MaistraVersion}/samples/bookinfo/platform/kube/bookinfo.yaml
9196
----
9297
+
93-
{ProductName} implements auto-injection differently than the upstream Istio project. This procedure uses a version of the `bookinfo.yaml` file annotated to enable automatic injection of the Istio sidecar for {ProductName}.
98+
You should see output similar to the following:
99+
+
100+
[source,terminal]
101+
----
102+
service/details created
103+
serviceaccount/bookinfo-details created
104+
deployment.apps/details-v1 created
105+
service/ratings created
106+
serviceaccount/bookinfo-ratings created
107+
deployment.apps/ratings-v1 created
108+
service/reviews created
109+
serviceaccount/bookinfo-reviews created
110+
deployment.apps/reviews-v1 created
111+
deployment.apps/reviews-v2 created
112+
deployment.apps/reviews-v3 created
113+
service/productpage created
114+
serviceaccount/bookinfo-productpage created
115+
deployment.apps/productpage-v1 created
116+
----
94117
+
95118
. Create the ingress gateway by applying the `bookinfo-gateway.yaml` file:
96119
+
@@ -99,7 +122,20 @@ $ oc apply -n bookinfo -f https://raw.githubusercontent.com/Maistra/istio/maistr
99122
$ oc apply -n bookinfo -f https://raw.githubusercontent.com/Maistra/istio/maistra-{MaistraVersion}/samples/bookinfo/networking/bookinfo-gateway.yaml
100123
----
101124
+
102-
. Set the value for the `GATEWAY_URL` parameter. You can use this variable to find the URL for your Bookinfo product page later. In this example, `istio-system` is the name of the control plane project.
125+
You should see output similar to the following:
126+
+
127+
[source,terminal]
128+
----
129+
gateway.networking.istio.io/bookinfo-gateway created
130+
virtualservice.networking.istio.io/bookinfo created
131+
----
132+
+
133+
. Set the value for the `GATEWAY_URL` parameter:
134+
+
135+
[NOTE]
136+
====
137+
Replace `<control_plane_project>` with the name of your control plane project. In this example, the control plane project is `istio-system`.
138+
====
103139
+
104140
[source,terminal]
105141
----

modules/ossm-tutorial-bookinfo-verify-install.adoc

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ This PROCEDURE module included in the following assemblies:
77
[id="ossm-tutorial-bookinfo-verify-install_{context}"]
88
= Verifying the Bookinfo installation
99

10-
Before configuring your application, verify that it successfully deployed.
10+
To confirm that the sample Bookinfo application was successfully deployed, perform the following steps.
1111

1212
.Prerequisites
1313

@@ -25,11 +25,24 @@ Before configuring your application, verify that it successfully deployed.
2525
----
2626
$ oc get pods -n bookinfo
2727
----
28-
28+
+
29+
All pods should have a status of `Running`. You should see output similar to the following:
30+
+
31+
[source,terminal]
32+
----
33+
NAME READY STATUS RESTARTS AGE
34+
details-v1-55b869668-jh7hb 2/2 Running 0 12m
35+
productpage-v1-6fc77ff794-nsl8r 2/2 Running 0 12m
36+
ratings-v1-7d7d8d8b56-55scn 2/2 Running 0 12m
37+
reviews-v1-868597db96-bdxgq 2/2 Running 0 12m
38+
reviews-v2-5b64f47978-cvssp 2/2 Running 0 12m
39+
reviews-v3-6dfd49b55b-vcwpf 2/2 Running 0 12m
40+
----
41+
+
2942
. Run the following command to retrieve the URL for the product page:
3043
+
3144
[source,terminal]
3245
----
3346
echo "http://$GATEWAY_URL/productpage"
3447
----
35-
. Paste the output in a web browser to verify the Bookinfo product page is deployed correctly.
48+
. Copy and paste the output in a web browser to verify the Bookinfo product page is deployed.

0 commit comments

Comments
 (0)