Skip to main content
Before you can start building agents, you need to set up your development environment. Follow these steps to configure your tools and access.

​
Required Tools

Ensure you have the following tools installed on your machine:
You can install these tools using Homebrew:
brew install azure-cli kubectl argo sops Azure/kubelogin/kubelogin

​
Configuration Steps

1

Set up Azure CLI

Log in to your Azure account:
az login
This will open your browser for authentication. Use your corporate credentials.
If you need a password reset for your Azure account, please contact your IT helpdesk.
2

Install VPN

Access to the platform requires a VPN connection.
Please refer to your organization’s internal documentation for instructions on installing and configuring the VPN client (e.g., Aviatrix).
3

Configure Webproxy

To access customer URLs or internal resources while on VPN, you may need to configure a web proxy.
Consult your network administrator or internal guides for the specific web proxy configuration settings.
4

Generate Kubeconfig

You need to generate a kubeconfig file to access the runtime environments. Make sure your VPN/Webproxy is active; the Kubernetes API is private.

​
For Development Runtime

# Create directory
mkdir -p ~/.kube/agbs

# Set subscription and get credentials
az account set --subscription <YOUR_SUBSCRIPTION_ID>
az aks get-credentials --resource-group <RESOURCE_GROUP_DEV> --name <CLUSTER_NAME_DEV> --file ~/.kube/agbs/dev

# Convert credentials
KUBECONFIG=~/.kube/agbs/dev kubelogin convert-kubeconfig

# Export variables (replace <WEBPROXY_URL> with your proxy address)
export http_proxy=<WEBPROXY_URL>
export https_proxy=<WEBPROXY_URL>
export KUBECONFIG=~/.kube/agbs/dev

# Verify connection
kubectl get deployments -n backbase

​
For Staging Runtime

# Set subscription and get credentials
az account set --subscription <YOUR_SUBSCRIPTION_ID>
az aks get-credentials --resource-group <RESOURCE_GROUP_STG> --name <CLUSTER_NAME_STG> --file ~/.kube/agbs/stg

# Convert credentials
KUBECONFIG=~/.kube/agbs/stg kubelogin convert-kubeconfig

# Export variables
export http_proxy=<WEBPROXY_URL>
export https_proxy=<WEBPROXY_URL>
export KUBECONFIG=~/.kube/agbs/stg

# Verify connection
kubectl get deployments -n backbase

​
Generate all kubeconfigs

You can also generate all kubeconfigs at once:
mkdir -p ~/.kube/agbs

# Dev
az account set --subscription <YOUR_SUBSCRIPTION_ID>
az aks get-credentials --resource-group <RESOURCE_GROUP_DEV> --name <CLUSTER_NAME_DEV> --file ~/.kube/agbs/dev
KUBECONFIG=~/.kube/agbs/dev kubelogin convert-kubeconfig

# Staging
az account set --subscription <YOUR_SUBSCRIPTION_ID>
az aks get-credentials --resource-group <RESOURCE_GROUP_STG> --name <CLUSTER_NAME_STG> --file ~/.kube/agbs/stg
KUBECONFIG=~/.kube/agbs/stg kubelogin convert-kubeconfig

# Quick smoke test
KUBECONFIG=~/.kube/agbs/dev kubectl get ns
Partner Access: For partner-led projects, IP whitelisting can be requested via support ticket to allow access to the cluster and key vault.
Next: provision your repo via Self Service and build your agent with Create Your First Agent.