This guide covers how you can quickly get started using various tools to access Cloudforest's API Documentation which auto-generated from API's Protobuffs

• Hugo
• Docker
• Kubernetes or Minikube

This repository can be deployed

• as Github Pages
• as Docker Image
• as Kubernetes Pod using Helm Chart
• as Hugo Server

Fork this repository and execute [PUSH] Deploy Hugo to GitHub Pages Github Actions to deploy as Github Pages.

Execute following command to run as Docker Image

1. Run Docker Image

   docker run -p 1313:1313 cloudforet/api-doc:{version}
   

Execute following command to run as Kubernetes Pod using Helm Chart

1. Add Helm Repository

   helm repo add cloudforet https://cloudforet-io.github.io/api-doc/deploy/helm
   

2. Create Namespace

   kubectl create namespace api-docs
   

3. Install Helm Chart

   helm install api-docs cloudforet/cloudforet-api-docs
   

Execute following command to run as Hugo Server

1. Clone this repository

   git clone https://cloudforet-io.github.io/api-doc.git
   

2. Update Submodule

   git submodule update --init --recursive
   

3. Run Hugo Server

   hugo server --gc --minify --theme hugo-book --baseUrl="https://localhost:1313"