Skip to main content

Getting Started

Installation and Setup​

To use OBLV Deploy, you will need to install the Kube OBLV Stack. The Kube OBLV Stack is an umbrella Helm chart that you can install onto your Kubernetes cluster. By installing this chart, you will have all that OBLV Deploy needs to run smoothly.

Users guide

This page content is for administrators who want to deploy an application with OBLV Deploy. If you are a user and want to connect to a deployed application, refer to the Making an Attested Connection guide.

Install Kube OBLV Stack​

To install Kube OBLV Stack, you need to follow the steps below:

Requirements

Be sure that you have completed the steps presented in the Prerequisites before proceeding with the installation of Kube OBLV Stack and OBLV CLI.

  1. Login to Amazon Elastic Container Registry (ECR).
aws ecr get-login-password --region eu-central-1 | helm registry login --username AWS --password-stdin ${AWS_CURRENT_ACCOUNT}.dkr.ecr.eu-central-1.amazonaws.com
  1. Install Kube OBLV Stack with Helm package manager.
helm install oblv-deploy-stack oci://${AWS_CURRENT_ACCOUNT}.dkr.ecr.eu-central-1.amazonaws.com/kube-oblv-stack \
    --version 0.1.0 \
    -n kube-system \
    --set oblv-deploy-chart.enabled=true \
    --set oblv-deploy-chart.metricsCollectorHostName=metrics.oblv.deploy.internal \
    --set ec2-chart.enabled=true \
    --set ec2-chart.aws.region=eu-central-1 \
    --set ec2-chart.serviceAccount.create=false \
    --set ec2-chart.serviceAccount.name=ack-ec2-controller \
    --set aws-load-balancer-controller.enabled=true \
    --set aws-load-balancer-controller.clusterName=${CLUSTER_NAME} \
    --set aws-load-balancer-controller.serviceAccount.create=false \
    --set aws-load-balancer-controller.serviceAccount.name=aws-load-balancer-controller \
    --set external-dns.enabled=true \
    --set external-dns.provider=aws \
    --set external-dns.txtOwnerId=${CLUSTER_NAME}-external-dns \
    --set external-dns.domainFilters\[0\]="{antigranular.com,oblv.deploy.internal}" \
    --set external-dns.serviceAccount.name=external-dns \
    --set external-dns.serviceAccount.create=false \
    --set external-dns.policy=sync
Kube OBLV Stack Reference

If you're not familiar with the configurations used to install the Kube OBLV Stack, you can access the Kube OBLV Stack reference page, where each property and configuration used in the code block above is explained.

Helm information

Helm is a package manager that simplifies installing charts on your Kubernetes cluster. AWS provides detailed instructions for installation and configuration here.

Auxiliary Commands for debugging

If you need help understanding the installation process, you can use the list of helpful commands for the development and debugging process available on the Auxiliary Commands Reference page.

What's Next?​

After finishing configuring Kube OBLV Stack, your cluster environment is ready for deployment. Access the Deployment page to continue with the Getting Started guide.