Deploy sample apps

After you set up Gloo Gateway, deploy sample apps, such as Bookinfo and httpbin, to explore the routing and traffic management capabilities in Gloo Gateway.

Deploy Bookinfo

1. Create the bookinfo namespace.

   kubectl create ns bookinfo
   

2. Deploy the Bookinfo app.

   • Kubernetes
   • OpenShift

   # deploy bookinfo application components for all versions
   kubectl -n bookinfo apply -f https://raw.githubusercontent.com/istio/istio/1.18.3/samples/bookinfo/platform/kube/bookinfo.yaml -l 'app'
   # deploy an updated product page with extra container utilities such as 'curl' and 'netcat'
   kubectl -n bookinfo apply -f https://raw.githubusercontent.com/solo-io/gloo-mesh-use-cases/main/policy-demo/productpage-with-curl.yaml
   # deploy all bookinfo service accounts
   kubectl -n bookinfo apply -f https://raw.githubusercontent.com/istio/istio/1.18.3/samples/bookinfo/platform/kube/bookinfo.yaml -l 'account'
   

   For more information, see the Istio on OpenShift documentation.

   1. Create a NetworkAttachmentDefinition custom resource for the bookinfo project, and elevate the permissions of the bookinfo service account to allow the pods to use a user ID that is normally restricted by OpenShift.

      cat <<EOF | oc -n bookinfo create -f -
      apiVersion: "k8s.cni.cncf.io/v1"
      kind: NetworkAttachmentDefinition
      metadata:
        name: istio-cni
      EOF
      
      oc adm policy add-scc-to-group anyuid system:serviceaccounts:bookinfo
      

   2. Deploy Bookinfo.

      # deploy bookinfo application components for all versions less than v3
      kubectl -n bookinfo apply -f https://raw.githubusercontent.com/istio/istio/1.18.3/samples/bookinfo/platform/kube/bookinfo.yaml -l 'app,version notin (v3)'
      # deploy an updated product page with extra container utilities such as 'curl' and 'netcat'
      kubectl -n bookinfo apply -f https://raw.githubusercontent.com/solo-io/gloo-mesh-use-cases/main/policy-demo/productpage-with-curl.yaml
      # deploy all bookinfo service accounts
      kubectl -n bookinfo apply -f https://raw.githubusercontent.com/istio/istio/1.18.3/samples/bookinfo/platform/kube/bookinfo.yaml -l 'account'
      

3. Verify that the Bookinfo app is deployed successfully.

   kubectl get pods -n bookinfo
   kubectl get svc -n bookinfo
   

Deploy httpbin

The httpbin sample app is a simple tool to test HTTP requests and responses. Unlike curl, you can see not only the response headers, but also the request headers.

1. Create an httpbin namespace.

   kubectl create ns httpbin
   

2. Create the httpbin app.

   • Kubernetes
   • OpenShift

   kubectl -n httpbin apply -f https://raw.githubusercontent.com/solo-io/gloo-mesh-use-cases/main/policy-demo/httpbin.yaml
   

   1. Create a NetworkAttachmentDefinition custom resource for the httpbin project, and elevate the permissions of the httpbin service account to allow the pod to use a user ID that is normally restricted by OpenShift. For more information, see the Istio on OpenShift documentation.

      cat <<EOF | oc -n httpbin create -f -
      apiVersion: "k8s.cni.cncf.io/v1"
      kind: NetworkAttachmentDefinition
      metadata:
        name: istio-cni
      EOF
      
      oc adm policy add-scc-to-group anyuid system:serviceaccounts:httpbin
      

   2. Deploy the app to your cluster.

      kubectl -n httpbin apply -f https://raw.githubusercontent.com/solo-io/gloo-mesh-use-cases/main/policy-demo/httpbin.yaml
      

3. Verify that the httpbin app is running.

   kubectl -n httpbin get pods
   

Next

Create an HTTP listener on your gateway and set up routing for the sample apps.