Skip to content

CiscoCloud/mantl-devnet-learninglabs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cisco DevNet Learning Labs: mantl-devnet-learninglabs

These self-paced interactive tutorials provide instructions for developers to deploy applications in Marathon, which is running inside of Mesos (as a Mesos framework).

We write these labs for display within the Cisco DevNet Learning Labs system.

Contributions are welcome, and we are glad to review changes through pull requests. See contributing.md for details.

Once approved, Cisco DevNet reviewers then create a release to publish through our Learning Labs system.

The goal of these learning labs is to ensure a 'hands-on' learning approach rather than theory or instructions.

About these Learning Labs

These labs teach how to:

  • Have a basic understanding of microservices, containers, and cloud-native applications.
  • Deploy applications in Marathon.
  • Deploy a Mantl.io Container cluster onto your local machine.
  • Have a basic understanding of containers.
  • Use Docker, a common toolchain for building, sharing and deploying containers.
  • Explore advanced Docker features for containers.
  • Have a basic understanding of Continuous Integration (CI) and Continuous Deployment (CD) techniques and principals.

If you need more help, you can reach out to DevNet through one of our support options.

Preview Learning Lab Markdown locally

Refer to the instruction for your text editor for Markdown previewing. For example, Markdown and Visual Studio Code describes how to configure Markdown extensions.

Contributor guidelines

These learning modules are for public consumption, so you must ensure that you have the rights to any content that you contribute.

Write your content in Markdown. DevNet staff reviews content according to the Cisco Style Guide. (Link available on Cisco VPN only.)

Publishing requirements

To create and publish a new lab, take the following steps:

  • Add a new folder under labs.
  • Create a JSON file with the same name as the labs/folder name.
  • Create markdown files named 1.md, 2.md, and so on; refer to those files in the labs/folder JSON file.
  • Ensure that the JSON file contains appropriate page titles and file references.
  • Send a pull request to get the files committed and merged to master by a DevNet reviewer.

A DevNet reviewer then creates a release on the repository with the latest master and publishes through the admin interface.

Editors

You can write Markdown in a plain text editor, and desktop and Web-based options allow you to simultaneously write and preview your work. We recommend Visual Studio Code Download for these reasons:

  • Lightweight environment for coding (or writing Markdown).
  • Available on macOS, Linux, or Windows.
  • Github Client integration.
  • Great Markdown preview features native in the editor.
  • Intuitive operation and structure.

You can validate a JSON file by using the online formatter and validator.

Getting involved

  • If you'd like to contribute to an existing lab, refer to contributing.md.
  • If you're interested in creating a new Cisco DevNet Learning Lab, please contact a DevNet administrator for guidance.