Microservices with ingress on Kubernetes cluster

These modules deploy a simple demo app to an IKS Cluster using a Cluster Ingress deployment.

Ingress Deployment

Setup
Deployment
Ingress Depolyment Pattern
Module Variables

Setup

Make sure that the ALBs in your cluster are enabled. If you want the app to be available publicly, make sure the public ALBs are enabled

Creating the Image In IBM Cloud Container Registry

In order to make sure this architecture deploys correctly, ensure that you have copied any icr image pull secrets into the namespace where the app will be deployed if you're using ICR for the images. You will need to have Docker installed locally. You can find more information on getting started with IBM Container Registry here.

Both of these deployment patterns use a node demo app. To upload this example application to IBM Cloud Container Registry follow these steps:

ibmcloud login

ibmcloud cr login

If you do not have a namespace you want to use with your app, create a namespace:

ibmcloud cr namespace-add <my_namespace>

In the ./node-demo-app directory run this command to build the docker container:

docker build . -t <image_name>:<tag>

Next, tag the image to upload to ICR

docker tag <image_name>:<tag> <region>.icr.io/<my_namespace>/<new_image_repo>:<new_tag>

Push the image to ICR

docker push <region>.icr.io/<my_namespace>/<new_image_repo>:<new_tag>

Deployment

This pattern creates an IKS deployment equivalant to this .yaml file:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: demo-app
  namespace: default
  labels:
    app: demo-app
spec:
  selector:
    matchLabels:
      app: test-app
  template:
    metadata:
      labels:
        app: api-service
    spec:
      containers:
      - image: <region>.icr.io/<my_namespace>/<new_image_repo>:<new_tag>
        name: test-app
        env:
            - name: PORT
              value: 8080

Ingress Depolyment Pattern

After the application deployed, the script creates a NodePoet service for the application with the specified service port that points to the application. The terraform script gets a list of enabled ALB IDs from the cluster is deployed and creates a semicolon separated list of them and uses it to create a cluster ingress resource.

Once your application has been deployed, you'll be able to visit it at <app_name>.<your_cluster_ingress>.

Module Variables

The following variables are used for both deployment methods.

Variable	Type	Description	Default
`ibmcloud_api_key`	String	The IBM Cloud platform API key needed to deploy IAM enabled resources
`generation`	String	Generation of VPC. Can be 1 or 2	`2`
`ibm_region`	String	IBM region for IKS on VPC cluster	`us-south`
`group`	String	Name of resource group to provision resources	`asset-development`
`app_name`	String	Name for app in kubernetes	`demo-app`
`namespace`	String	Namespace to deploy application	`default`
`container_name`	String	Name for container in deployment	`api-service`
`app_image`	String	link to app image to install
`app_port`	String	Port for app to run	`8080`
`protocol`	String	Service protocol	`TCP`
`service_port`	String	Port for application	`8080`
`cluster_name`	String	name of IKS cluster

Cloud-Schematics/iks-on-vpc-deploy-demo-ingress-app