Deploy a STAC API and a dynamic mosaic tiler API using AWS CDK.

Earth Observation API

Deploy a STAC API and a dynamic mosaic tiler API using AWS CDK.

Source Code: https://github.com/developmentseed/eoAPI

Deployment

The stack is deployed by the AWS CDK utility. Under the hood, CDK will create the deployment packages required for AWS Lambda, upload it to AWS, and handle the creation of the Lambda and API Gateway resources.

1. Install CDK and connect to your AWS account. This step is only necessary once per AWS account.

   # Download titiler repo
   $ git clone https://github.com/developmentseed/eoapi.git
   
   # install cdk dependencies
   $ pip install -r deployment/requirements.txt
   $ npm install
   
   $ npm run cdk bootstrap # Deploys the CDK toolkit stack into an AWS environment
   
   # in specific region
   $ npm run cdk bootstrap aws://${AWS_ACCOUNT_ID}/eu-central-1

2. Pre-Generate CFN template

   $ npm run cdk synth  # Synthesizes and prints the CloudFormation template for this stack

3. Update settings

   Using environment variable or editing deployment/cdk/config.py

4. Deploy

   $ EOAPI_STAGE=staging npm run cdk deploy eoapi-staging --profile {my-aws-profile}
   
   # Deploy in specific region
   $ AWS_DEFAULT_REGION=eu-central-1 AWS_REGION=eu-central-1 npm run cdk deploy eoapi-production --profile {my-aws-profile}

STAC + PgSTAC + TiTiler

The dyanic tiler deployed within eoAPI is built on top of titiler-pgstac and pgstac. It enables large scale mosaic based on results of STAC searches queries:

Local

You can launch the APIs locally using docker. This will start 3 services: database, eoapi.stac, eoapi.raster

$ git clone https://github.com/developmentseed/eoAPI.git
$ cd eoAPI
$ docker-compose build
$ docker-compose up

Project structure

 ├──demo/                  - items/collections and notebook
 ├──deployment/            - AWS CDK code
 └──src/eoapi/
    ├── raster/            - eoAPI raster Application package
    ├── stac/              - eoAPI stac Application package
    └── vector/            - eoAPI vector Application package [EXPERIMENTAL]

Contribution & Development

See CONTRIBUTING.md

License

See LICENSE

Authors

Created by Development Seed

See contributors for a listing of individual contributors.

Changes

See CHANGES.md.