Merge pull request #75629 from xJustin/OSDOCS-8390-deployment

OSDOCS-8390 rosaworkshop.io deployment

Author: EricPonvelle

_topic_maps/_topic_map_rosa.yml

@@ -186,6 +186,8 @@ Topics:
     File: cloud-experts-deploying-application-prerequisites
   - Name: Lab Overview
     File: cloud-experts-deploying-application-lab-overview
+  - Name: Deployment
+    File: cloud-experts-deploying-application-deployment
   - Name: Networking
     File: cloud-experts-deploying-application-networking
 ---

cloud_experts_tutorials/cloud-experts-deploying-application/cloud-experts-deploying-application-deployment.adoc

@@ -0,0 +1,153 @@
+:_mod-docs-content-type: ASSEMBLY
+[id="cloud-experts-deploying-application-deployment"]
+= Tutorial: Deploying an application
+include::_attributes/attributes-openshift-dedicated.adoc[]
+:context: cloud-experts-deploying-application-deployment
+
+toc::[]
+
+//rosaworkshop.io content metadata
+//Brought into ROSA product docs 23-JAN-2024
+
+== Deploying the OSToy application with Kubernetes
+
+You can deploy the OSToy application by creating and storing the images for the front-end and back-end microservice containers in an image repository. You can then create Kubernetes deployments to deploy the application. 
+
+=== Retrieving the login command
+
+. If you are not logged in to the CLI, access your cluster with the web console.
+
+. Click the dropdown arrow next to your login name in the upper right, and select *Copy Login Command*.
++
+image::4-cli-login.png[CLI login screen]
++
+A new tab opens. 
+
+. Select your authentication method.
+
+. Click *Display Token*.
+
+. Copy the command under *Log in with this token*. 
+
+. From your terminal, paste and run the copied command. If the login is successful, you will see the following confirmation message:
++
+[source,terminal]
+----
+$ oc login --token=<your_token> --server=https://api.osd4-demo.abc1.p1.openshiftapps.com:6443
+Logged into "https://api.myrosacluster.abcd.p1.openshiftapps.com:6443" as "rosa-user" using the token provided.
+
+You don't have any projects. You can try to create a new project, by running
+
+oc new-project <project name>
+----
+
+=== Creating a new project
+
+==== Using the CLI
+
+. Create a new project named `ostoy` in your cluster by running following command:
++
+[source,terminal]
+----
+$ oc new-project ostoy
+----
++
+.Example output
+[source,terminal]
+----
+Now using project "ostoy" on server "https://api.myrosacluster.abcd.p1.openshiftapps.com:6443".
+----
+
+. *Optional*: Alternatively, create a unique project name by running the following command:
++
+[source,terminal]
+----
+$ oc new-project ostoy-$(uuidgen | cut -d - -f 2 | tr '[:upper:]' '[:lower:]')
+----
+
+==== Using the web console
+
+. From the web console, click *Home -> Projects*. 
+
+. On the *Projects* page, click create *Create Project*.
++
+image::4-createnewproj.png[The project creation screen]
+
+=== Deploying the back-end microservice
+
+The microservice serves internal web requests and returns a JSON object containing the current hostname and a randomly generated color string.
+
+* Deploy the microservice by running the following command from your terminal:
++
+[source,terminal]
+----
+$ oc apply -f https://raw.githubusercontent.com/openshift-cs/rosaworkshop/master/rosa-workshop/ostoy/yaml/ostoy-microservice-deployment.yaml
+----
++
+.Example output
+[source,terminal]
+----
+$ oc apply -f https://raw.githubusercontent.com/openshift-cs/rosaworkshop/master/rosa-workshop/ostoy/yaml/ostoy-microservice-deployment.yaml
+deployment.apps/ostoy-microservice created
+service/ostoy-microservice-svc created
+----
+
+=== Deploying the front-end service
+
+The front-end deployment uses the Node.js front-end for the application and additional Kubernetes objects.
+
+The `ostoy-frontend-deployment.yaml` file shows that front-end deployment defines the following features:
+
+- Persistent volume claim
+- Deployment object
+- Service
+- Route
+- Configmaps
+- Secrets
+
+* Deploy the application front-end and create all of the objects by entering the following command:
++
+[source,terminal]
+----
+$ oc apply -f https://raw.githubusercontent.com/openshift-cs/rosaworkshop/master/rosa-workshop/ostoy/yaml/ostoy-frontend-deployment.yaml
+----
++
+.Example output
+[source,terminal]
+----
+persistentvolumeclaim/ostoy-pvc created
+deployment.apps/ostoy-frontend created
+service/ostoy-frontend-svc created
+route.route.openshift.io/ostoy-route created
+configmap/ostoy-configmap-env created
+secret/ostoy-secret-env created
+configmap/ostoy-configmap-files created
+secret/ostoy-secret created
+----
++
+You should see all objects created successfully.
+
+=== Getting the route
+
+You must get the route to access the application.
+
+* Get the route to your application by running the following command:
++
+[source,terminal]
+----
+$ oc get route
+----
++
+.Example output
+[source,terminal]
+----
+NAME          HOST/PORT                                                 PATH   SERVICES             PORT    TERMINATION   WILDCARD
+ostoy-route   ostoy-route-ostoy.apps.<your-rosa-cluster>.abcd.p1.openshiftapps.com          ostoy-frontend-svc   <all>                 None
+----
+
+=== Viewing the application
+
+. Copy the `ostoy-route-ostoy.apps.<your-rosa-cluster>.abcd.p1.openshiftapps.com` URL output from the previous step.
+. Paste the copied URL into your web browser and press enter. You should see the homepage of your application. If the page does not load, make sure you use `http` and not `https`.
++
+image::4-ostoy-homepage.png[OStoy application homepage]