Sample 2 - Deployment Params and Certs

Let's deploy a backend using Target Endpoint resource on your Kubernetes environment and apply API management.

Prerequisites

  • Install a Kubernetes cluster and v1.14+ client. Alternatively, you can run Kubernetes locally via Minikube.
  • Install Docker.
  • Install the Kubernetes API Operator.
  • Setup Choreo Connect

    1. Download the Choreo Connect v0.9.0 from github release page's assets and extract them to a folder of your choice. We will refer to this folder as the CHOREO-CONNECT_HOME.

    2. Using the kubectl tool, apply Kubernetes configurations for Choreo Connect.

      kubectl apply -f <CHOREO-CONNECT_HOME>/k8s-artifacts/choreo-connect
  • Install API controller Download the api controller (apictl) from the github release page's assets and extract them to a folder of your choice.

    export PATH=$PATH:<CLI_TOOL_EXTRACTED_LOCATION>

Step 1: Initialize an API-CTL Project

apictl init cert-products \
    --oas https://raw.githubusercontent.com/wso2/k8s-api-operator/v2.0.0/scenarios/scenario-2-endpoint-cert-override/swagger.yaml

Let's zip the project and create the k8s ConfigMap "cert-products-cm".

zip -r cert-products.zip cert-products/
kubectl create cm cert-products-cm --from-file cert-products.zip

Step 2: Create ConfigMap for Certs

openssl req -x509 -newkey rsa:4096 -nodes -days 365 \
    -subj "/O=wso2.com Inc./CN=cert-products" \
    -keyout products-certs.key \
    -out products-certs.crt

Create k8s ConfigMap "cert-products-certs".

kubectl create cm cert-products-certs \
    --from-file products-certs.crt

Step 3: Create Params ConfigMap

Let's generate the deployment directory using apictl.

apictl k8s gen deployment-dir -s cert-products/

Note

you can also use the API-CTL project zip to create deployment-dir.

apictl k8s gen deployment-dir -s cert-products.zip

You can see a directory created with the name DeploymentArtifacts_cert-products. Edit the DeploymentArtifacts_cert-products/params_cm.yaml file with the following content.

apiVersion: v1
kind: ConfigMap
metadata:
  name: cert-products-params
data:
  params.yaml: |
    environments:
        - name: production
          configs:
              endpoints:
                  production:
                    url: https://products-certs
                  sandbox:
                    url: https://products-certs
              certs:
                  - hostName: products-certs
                    alias: products-certs
                    path: products-certs.crt

Apply the edited ConfigMap to the cluster.

kubectl apply -f DeploymentArtifacts_cert-products/params_cm.yaml

Step 4: Deploy API

You can see the API custom resource yaml file is generated with the directory previously created. Apply it to the cluster.

kubectl apply -f DeploymentArtifacts_cert-products/api_crd.yaml
Top