Turn an Earth Observation processor repository into a scanned, published container image and an OGC Application Package (CWL) deployed to Insula, CGI's Earth Observation platform.
| Repository | What it is |
|---|---|
insula-processor-template |
Template and scaffold for a processor: code/ + Dockerfile, an OGC Application Package (CWL), and the publishing workflow. |
insula-processors-builder-cli |
Python CLI (insula-processors-builder) to build, security-scan, publish, and deploy a processor to Insula. |
| Repository | What it does |
|---|---|
processor-eumon |
Sentinel-3 pre-processing chain for eutrophication monitoring. |
processor-gdaevapotranspiration-earthcode |
Estimates daily evapotranspiration from Sentinel-2 and Sentinel-3 morning acquisitions using the Two-Source Energy Balance (TSEB) algorithm and machine-learning-sharpened Land Surface Temperature, with the Sen-ET project as baseline. |
Use these as working references for structuring your own processor.
- Scaffold a processor repository from the template (your
code/, aDockerfile, and a.cwl). - Run the CLI. It triggers the Insula build pipeline, which runs your code through
four checkpoints:
- Secret scan - a verified secret stops the build.
- Build - your
code/Dockerfileis built into a container image. - Security scan - a HIGH or CRITICAL vulnerability stops the build.
- Publish - a clean image is published automatically.
- The pipeline finalizes your Application Package (CWL) with the published image.
- The CLI downloads the CWL and deploys it to Insula. Your API token stays on your machine and is never sent to the pipeline.
Collaborator membership is required only to use the pipeline to build and publish your processor. Browsing the repositories, scaffolding from the template, and inspecting the example processors need no membership.
To build and publish a processor through this organization, request collaborator membership from the Insula Processors maintainers.
Then read the
insula-processor-template README
for the full, detailed instructions.
# 1. Scaffold a processor repository
cookiecutter gh:cgi-italy-insula-processors/insula-processor-template
# 2. Install the builder CLI
pipx install git+https://github.com/cgi-italy-insula-processors/insula-processors-builder-cli
# 3. Build and deploy
insula-processors-builder create