Deploying Apica Ascent PaaS on MicroK8s
MicroK8s is a lightweight, pure-upstream Kubernetes aiming to reduce entry barriers for K8s and cloud-native application development. It comes in a single package that installs a single-node (standalone) K8s cluster in under 60 seconds. The lightweight nature of Apica Ascent PaaS enables you to deploy Apica Ascent on lightweight, single-node clusters like MicroK8s.
The following guide takes you through deploying Apica Ascent PaaS on MicroK8s.
Installing MicroK8s
The first step in this deployment is to install MicroK8s on your machine. To install MicroK8s, do the following.
Update package lists by running the following command.
Install
core
using Snap by running the following command.Install MicroK8s using Snap by running the following command.
Join the group created by MicroK8s that enables uninterrupted usage of commands that require admin access by running the following command.
Create the .kube directory
Add your current user to the group to gain access to the
.kube
caching directory by running the following command.Generate your MicroK8s configuration and merge it with your Kubernetes configuration by running the following command.
Check whether MicroK8s is up and running with the following command.
MicroK8s is now installed on your machine.
Enabling add-ons
Now that we have MicroK8s up and running, let’s set up your cluster and enable the add-ons necessary such as Helm, CoreDNS, ingress, storage, and private registry. MicroK8s readily provides these addons and can be enabled and disabled at any time. Most of these add-ons are pre-configured to work without any additional setup.
To enable add-ons on your MicroK8s cluster, run the following commands in succession.
Enable Helm 3.
Enable a default storage class that allocates storage from a host directory.
Enable CoreDNS.
Enable ingress.
To enable the Ingress controller in MicroK8s, run the following command:
Enable HTTPS
How to Create a Self-Signed Certificate using OpenSSL
Create server private key
Create certificate signing request (CSR)
Sign the certificate using the private key and CSR
To create a TLS secret in MicroK8s using
kubectl
, use the following command:This command creates a secret named "https" containing the TLS keys for use in your Kubernetes cluster. Ensure you have the
cert.crt
andcert.key
files in your current directory or specify full paths.To enable Ingress on microk8s with a default SSL certificate, issue the following command:
Enable private registry.
Copy over your MicroK8s configuration to your Kubernetes configuration with the following command.
Provisioning an IP address
In this step, we'll provision an endpoint or an IP address where we access Apica Ascent PaaS after deploying it on MicroK8s. You can skip this step if its your local implementation. For this, we'll leverage MetalLB which is a load-balancer implementation that uses standard routing protocols for bare metal Kubernetes clusters.
Note: Since MetalLB is available as an add-on for MicroK8s, you can also run these steps while enabling add-ons for your MicroK8s cluster.
To provision an IP address, do the following:
Check your local machine's IP address by running the
ifconfig
command, as shown below.Enable MetalLB by running the following command.
Note: MetalLB will not work on macOS due to network filtering that macOS applies. MetalLB might not work if you're provisioning an EC2 instance on AWS due to your private/public IP configuration.
Installing Apica Ascent PaaS
Now that your MicroK8s environment is configured and ready, we can proceed with installing Apica Ascent PaaS on it. To install Apica Ascent PaaS using Helm, do the following:
Add the Apica Ascent PaaS Helm chart to your Helm repository by running the following command.
Update your Helm repository by running the following command.
Create a namespace on MicroK8s on which to install Apica Ascent PaaS.
Prepare your values.microk8s.yaml file. You can use the starter
values.microk8s.yaml
file we've created to configure your Apica Ascent PaaS deploymentOptionally, if you are provisioning public IP using Metallb, use the values.yaml instead. run the following command.
In the values file, add the below fields global-> environment section with your own values.
In the global -> chart section, change S3gateway to false.
In the global -> persistence section, change storageClass as below.
Install Apica Ascent PaaS using Helm with the storage class set to
microk8s-hostpath
with the following command.
Apica Ascent PaaS is now installed in your MicroK8s environment.
Accessing Apica Ascent PaaS
Now that Apica Ascent PaaS is installed on your MicroK8s cluster, you can visit the Apica Ascent PaaS UI by accessing the MetalLB endpoint we defined in the pre-install steps. To access the Apica Ascent PaaS UI, do the following:
Inspect the pods in your MicroK8s cluster in the
logiq
namespace by running the following command.Find the exact MetalLB endpoint that's serving the Apica Ascent PaaS UI by running the following command.
The above command should give you an output similar to the following.
Using a web browser of your choice, access the IP address shown by the load balancer service above. For example,
http://192.168.1.27:80
.
Your Apica Ascent PaaS UI is now available in your web browser. You can log into Apica Ascent PaaS using the following default credentials.
Username:
flash-admin@foo.com
Password:
flash-password
Note: You can change the default login credentials after you've logged into the UI.
Last updated