Skip to content

Creating a RESTful Service - Go

This "stock ticker" sample demonstrates how to create and run a simple RESTful service on Knative Serving. The exposed endpoint outputs the stock price for a given "stock symbol", like AAPL,AMZN, GOOG, MSFT, etc.


  1. A Kubernetes cluster with Knative Serving installed and DNS configured.
  2. Docker installed locally.
  3. envsubst installed locally. This is installed by the gettext package. If not installed it can be installed by a Linux package manager, or by Homebrew on OS X.
  4. Download a copy of the code:
git clone -b "release-0.26" knative-docs
cd knative-docs


In order to run an application on Knative Serving a container image must be available to fetch from a container registry.

This sample uses Docker for both building and pushing.

To build and push to a container registry using Docker:

  1. From the knative-docs directory, run the following command to set your container registry endpoint as an environment variable.

This sample uses Google Container Registry (GCR):

  1. Set up your container registry to make sure you are ready to push.

To push to GCR, you need to:

If you are using a different container registry, you will want to follow the registry specific instructions for both setup and authorizing the image push.

  1. Use Docker to build your application container:
docker build \
  --tag "${REPO}/rest-api-go" \
  --file docs/serving/samples/rest-api-go/Dockerfile .
  1. Push your container to a container registry:
docker push "${REPO}/rest-api-go"
  1. Substitute the image reference path in the template with our published image path. The following command substitutes using the ${REPO} variable into a new file called docs/serving/samples/rest-api-go/sample.yaml.
envsubst < docs/serving/samples/rest-api-go/sample-template.yaml > \

Deploy the Service

Now that our image is available from the container registry, we can deploy the Knative Serving sample:

kubectl apply --filename docs/serving/samples/rest-api-go/sample.yaml

This command creates a Knative Service within your Kubernetes cluster in the default namespace.

Explore the Service

The Knative Service creates the following child resources:

  • Knative Route
  • Knative Configuration
  • Knative Revision
  • Kubernetes Deployment
  • Kubernetes Service

You can inspect the created resources with the following kubectl commands:

  • View the created Service resource:
kubectl get ksvc stock-service-example --output yaml
  • View the created Route resource:
kubectl get route -l \
"" --output yaml
  • View the Kubernetes Service created by the Route
kubectl get service -l \
"" --output yaml
  • View the created Configuration resource:
kubectl get configuration -l \
"" --output yaml
  • View the Revision that was created by our Configuration:
kubectl get revision -l \
"" --output yaml
  • View the Deployment created by our Revision
kubectl get deployment -l \
"" --output yaml

Access the Service

To access this service and run the stock ticker, you first obtain the service URL, and then you run curl commands to send request with your stock symbol.

  1. Get the URL of the service:
kubectl get ksvc stock-service-example,URL:.status.url
NAME                    URL
  1. Send requests to the service using curl:

  2. Send a request to the index endpoint:


    Response body: Welcome to the stock app!

  3. Send a request to the /stock endpoint:


    Response body: stock ticker not found!, require /stock/{ticker}

  4. Send a request to the /stock endpoint with your "stock symbol":


    where <SYMBOL> is your "stock symbol".

    Response body: stock price for ticker <SYMBOL> is <PRICE>




    Response: stock price for ticker FAKE is 0.00

Clean Up

To clean up the sample Service:

kubectl delete --filename docs/serving/samples/rest-api-go/sample.yaml
Back to top

We use analytics and cookies to understand site traffic. Information about your use of our site is shared with Google for that purpose. Learn more.

× OK