Skip to content

Quick Start Guide for Open-Source Kyma ​

Follow the steps to get started with the open-source API Gateway module.

Prerequisites ​

You have created a k3d cluster and added the Istio and API Gateway modules. See Quick Install.

Context ​

This quick start guide shows how to create a sample HTTPBin workload and expose it to the internet using the APIRule custom resource (CR). For this purpose, the guide uses a wildcard public domain *.local.kyma.dev. The domain is registered in public DNS and points to the local host 127.0.0.1.

Procedure ​

Create a Workload ​

Expose a Workload ​

Access a Workload ​

To access the HTTPBin Service, use curl.

  • Send a GET request to the HTTPBin Service.

    bash
    curl -ik -X GET https://httpbin.local.kyma.dev:30443/ip

    If successful, the call returns the 200 OK response code.

  • Send a POST request to the HTTPBin Service.

    bash
    curl -ik -X POST https://httpbin.local.kyma.dev:30443/post -d "test data"

    If successful, the call returns the 200 OK response code.