eoapi-k8s

Table of Contents

• What is eoAPI
• Getting Started
• Helm Installation
• Default Configuration and Options
• Autoscaling

What is eoAPI?

https://eoapi.dev/

Getting Started

If you don't have a k8s cluster set up on AWS or GCP then follow an IaC guide below that is relevant to you

ⓘ The helm chart in this repo assumes your cluster has a few third-party add-ons and controllers installed. So it's in your best interest to read through the IaC guides to understand what those defaults are

• AWS EKS Cluster Setup

• GCP GKE Cluster Setup

Helm Installation

Once you have a k8s cluster set up you can helm install eoAPI with the following steps:

0. eoapi-k8s depends on the Crunchydata Postgresql Operator. Install that first:

   $ helm install --set disable_check_for_upgrades=true pgo oci://registry.developers.crunchydata.com/crunchydata/pgo --version 5.5.2

1. Add the eoapi repo from https://devseed.com/eoapi-k8s/:

     $ helm repo add eoapi https://devseed.com/eoapi-k8s/

2. List out the eoapi chart versions

   $ helm search repo eoapi --versions
   NAME            CHART VERSION   APP VERSION     DESCRIPTION                                       
   eoapi/eoapi     0.2.14          0.3.1           Create a full Earth Observation API with Metada...
   eoapi/eoapi     0.1.13          0.2.11          Create a full Earth Observation API with Metada...

3. Optionally override keys/values in the default values.yaml with a custom config.yaml like below:

   $ cat config.yaml 
   vector:
     enable: false
   pgstacBootstrap:
     settings:
       envVars:
         LOAD_FIXTURES: "0"
         RUN_FOREVER: "1"

4. Then helm install with those config.yaml values:

   $ helm install -n eoapi --create-namespace eoapi eoapi/eoapi --version 0.1.2 -f config.yaml

5. or check out this repo and helm install from this repo's helm-chart/ folder:

     ######################################################
     # create os environment variables for required secrets
     ######################################################
     $ export GITSHA=$(git rev-parse HEAD | cut -c1-10)
   
     $ cd ./helm-chart
   
     $ helm install \
         --namespace eoapi \
         --create-namespace \
         --set gitSha=$GITSHA \
         eoapi \
         ./eoapi

Configuration Options and Defaults

Read about Default Configuration and other Configuration Options in the documentation