Slide decks and Instruqt code for Vault Workshops
MPL-2.0 License
All HashiCorp field workshops focused on Vault should be placed in this repository. Similar field workshop repositories exist for these HashiCorp solutions:
Additionally, field workshops focused on more than one HashiCorp solution can be found in the field-workshops-hashistack repository.
The only current workshop is Introduction to Vault with these slides: https://hashicorp.github.io/field-workshops-vault/slides/multi-cloud/vault-community/#1
The slides for these workshops should be created using Remark and should be placed under the docs/slides directory. This directory is organized by cloud and then by workshop. If a workshop targets a single cloud, its slides should be placed in a directory under that cloud's directory (aws, azure, or gcp). If a workshop can be used with multiple clouds, its slides should be placed in a directory under the multi-cloud directory.
Please do NOT place any slides or any other content directly inside the docs directory.
Standard assets (logos, backgrounds, css, fonts, and js) used by workshop slides are contained in a separate repository, field-workshops-assets.
When creating slides for a new workshop, you will need to do the following:
docs
under it.)index.md
and add all your slides to it.
vault-1.md
, vault-2.md
, and vault-3.md
with corresponding HTML files such as vault-1.html
, vault-2.html
, and vault-3.html
that should be copies of index.html
.index.md
with the name of the corresponding MD file in the sourceURLs
list. For instance, use vault-1.md
in vault-1.html
.index.md
in the sourceURLs
list of your workshop's copy of index.html
with a comma-delimited list of your MD file names. So, with the 3 MD files listed above, you would specify sourceURLs
like this:sourceUrls = [
'vault-1.md',
'vault-2.md',
'vault-3.md'
]
Whether you create a single-part or multi-part slide show, users will be able to access all of your slides with a URL like https://hashicorp.github.io/field-workshops-vault/slides/aws/vault-community/index.html, but they can leave off index.html
.
If you create a multi-part slide show, users will also be able to access each part of your slide show separately at URLs like these:
Each workshop should give the full link (or links) to that workshop's slides in one of its first few slides.
The instructor guides for these workshops should be created as Markdown files and should be placed in the instructor-guides directory and have names like <cloud>_<workshop_name>_INSTRUCTOR_GUIDE.md
where <cloud>
is the cloud the workshop targets and <workshop_name>
is the name of the workshop. But if the workshop is intended for use with multiple clouds, <cloud>
should be omitted.
The labs for these workshops should be created using Instruqt Tracks. Each track should be placed in its own directory directly underneath the instruqt-tracks directory. Doing this allows each track to be used by multiple workshops within this repository.
We currently have 3 standard Instruqt tracks for the Vault Workshop:
There are also 3 optional tracks: