Running Apidog on Kubernetes

This is for running Apidog on Kubernetes. If you're trying to run Apidog on Docker, check out these instuctions.

Preparing for deployment

Prerequisites:

Access Token for the private Docker Hub repository (obtained via email)

Configured application database and storage service following Configuring the application database and Configuring the application storage service.

Preparing the Docker Image:

Log in to Docker Hub:

docker login --username=apidog docker.io

Pull the latest Docker image:

docker pull docker.io/apidog/apidog-ee:<image_tag>

Running Apidog using deployment YAML file

Modify the provided Kubernetes Deployment YAML file with your specific information:

Replace <image_tag> with the desired image tag.

Fill in the environment variables with your database and storage service configurations.

Update the BASE_URL variable with the IP address or domain name for your API service.

Deploy the Apidog application using the modified YAML file. kubectl apply -f deployment.yaml

Running Apidog using Helm chart

Download and Setup

Download the Helm chart:

Configure the chart:

Edit the values.yaml file to match your environment configuration. Update database connections, Redis settings, and other environment-specific values.

Helm Commands

Installing the Chart

Upgrading the Deployment

kubectl Commands for Managing Apidog Pods

After deploying with Helm, you can use kubectl commands to manage and troubleshoot your Apidog deployment:

Viewing Pods and Logs

Interactive Shell Access

Integrating with Vault service

If you are using Vault service like HashiCorp Vault to manage secret environment variables, modify the chart's entrypoint and command as follows:

Verify successful startup

Execute the following command in the container:

The application has started successfully if the output includes lines similar to the following:

...
[WARN] This Redis server's `default` user does not require a password, but a password was supplied
connect succeeded! value is  null
Executing (default): SELECT 1+1 AS result
...
Connecting to 127.0.0.1:3000 (127.0.0.1:3000)
remote file exists
Connecting to 127.0.0.1 (127.0.0.1:80)
remote file exists
Connecting to 127.0.0.1 (127.0.0.1:80)
remote file exists

If the output differs, the application has not started successfully or is still starting. The typical time for a graceful startup is 30 seconds, but this may vary depending on the performance of the hardware.

Run the application

To access the service, follow the instructions below:

For web access:

Open your web browser and navigate to the URL specified by the BASE_URL environment variable. This URL typically follows the format https://api.example.com/web/ or http://192.168.0.13/web.

For desktop application access:

Upon launching the application for the first time, you will be prompted to enter the Server Base URL. Ensure this URL does not include a trailing slash.

Seed Installing Apidog Client

Additional Resources

Environment variables: Configuration Guide

Troubleshooting: Troubleshooting Guide

Preparing for deployment#

Running Apidog using deployment YAML file#

Running Apidog using Helm chart#

Download and Setup#

Helm Commands#

Installing the Chart#

Upgrading the Deployment#

kubectl Commands for Managing Apidog Pods#

Viewing Pods and Logs#

Interactive Shell Access#

Integrating with Vault service#

Verify successful startup#

Run the application#

For web access:#

For desktop application access:#

Additional Resources#