Hydra Academy Hydra CLI
Hydra CLI
From an empty folder to a tested job and an HTTP API, with hdrctl. Each video follows a Killercoda lab you can run in your browser.
- 01
Getting started with hdrctl on Killercoda
A first look at hdrctl, the Hydra ETL command line, in a free Killercoda playground.
- Open the Hydra ETL labs on Killercoda
- Check the installed version with
hdrctl --version - List the commands with
hdrctl --help - Get help on one command with
hdrctl init -h - Switch the CLI to Spanish with
--lang es
- 02
Create a project with hdrctl init and explore its structure
hdrctl init scaffolds a complete Hydra ETL project in one command. What it creates, and what each file does.
- Create a project with
hdrctl init - Read its structure:
Data/,output/,workflows/,jobs/job1/,.hydra/ - The four files of a job: sources, destinations, transformations, pipeline
- Edit them in the Killercoda Editor, with the HYDRA ETL extension
- Create a project with
- 03
Check a MySQL job before running it with hdrctl test
hdrctl test goes through a job section by section and tells you what is wrong before you run it.
- Create a MySQL project; credentials come from environment variables
- Break the load mode:
upsretinstead ofupsert - Read the error:
Input should be 'append', 'replace' or 'upsert' - Fix it and test again until everything passes
- 04
Hydra ETL over HTTP: hdrctl serve and the REST API
hdrctl serve starts a REST API, so any HTTP client can drive Hydra ETL.
- Start the API with
hdrctl serve --no-studio --port 5678 - Call
/api/healthwith curl - Validate a job over HTTP, then read the error returned as JSON
- Try Hydra DSL in the playground on hydraetl.com
- Start the API with