In this scenario, you will learn how to create your first Katacoda scenario. It will explain the essential aspects and the design decisions that you need to be aware of.
Creating Your First Katacoda Scenario
Step 1 - Scenario Structure
A Katacoda scenario is a series of Markdown files, bash scripts and a JSON file to define how your scenario should be configured, the text for the scenario and any automation required.
Clone our example repository that contains the set of documentation with the following command:
git clone https://github.com/katacoda/scenario-examples.git katacoda-scenario-examples
Within the repository, you will see a set of examples of implementing various Katacoda functionality.
The scenario you are currently reading is in the directory
ls -lha katacoda-scenario-examples/create-scenario-101. The directory name is what defines the URL.
An example of the current step is
All the steps are collected via a JSON file, for example,
The JSON file defines the scenario title, the description, steps order, the UI layout and environment. You can find more about the layouts within our scenarios at katacoda.com/docs/scenarios/layouts and environments at katacoda.com/docs/scenarios/environments.