mirror of
https://github.com/CiscoDevNet/cml-community.git
synced 2025-10-22 23:32:01 +00:00
Compare commits
3 Commits
12aef0e592
...
a0f1f4b6aa
Author | SHA1 | Date | |
---|---|---|---|
|
a0f1f4b6aa | ||
|
91def995a0 | ||
|
f9801dddfc |
27
.gitmodules
vendored
27
.gitmodules
vendored
@@ -1,27 +0,0 @@
|
||||
[submodule "use-cases/cml-class-automation"]
|
||||
path = use-cases/cml-class-automation
|
||||
url = https://github.com/CiscoDevNet/cml-class-automation
|
||||
[submodule "use-cases/cml-cicd"]
|
||||
path = use-cases/cml-cicd
|
||||
url = https://github.com/CiscoDevNet/cml-cicd
|
||||
[submodule "use-cases/dst-automation"]
|
||||
path = use-cases/dst-automation
|
||||
url = https://github.com/CiscoDevNet/dst-automation
|
||||
[submodule "use-cases/virlutils"]
|
||||
path = use-cases/virlutils
|
||||
url = https://github.com/CiscoDevNet/virlutils
|
||||
[submodule "use-cases/ansible-cml"]
|
||||
path = use-cases/ansible-cml
|
||||
url = https://github.com/CiscoDevNet/ansible-cml
|
||||
[submodule "use-cases/sdwan-devops"]
|
||||
path = use-cases/sdwan-devops
|
||||
url = https://github.com/CiscoDevNet/sdwan-devops
|
||||
[submodule "lab-topologies/ciscolive-brkcrt-2059"]
|
||||
path = lab-topologies/ciscolive-brkcrt-2059
|
||||
url = https://github.com/CiscoLearning/ciscolive-brkcrt-2059.git
|
||||
[submodule "use-cases/cloud-cml"]
|
||||
path = use-cases/cloud-cml
|
||||
url = https://github.com/CiscoDevNet/cloud-cml.git
|
||||
[submodule "scripts/eve2cml"]
|
||||
path = scripts/eve2cml
|
||||
url = https://github.com/CiscoDevNet/eve2cml.git
|
27
README.md
27
README.md
@@ -4,8 +4,8 @@
|
||||
|
||||
Community Contributed Content and Resources for Cisco Modeling Labs
|
||||
|
||||

|
||||
|
||||

|
||||
|
||||
## Repository Description
|
||||
|
||||
[Cisco Modeling Labs](http://developer.cisco.com/modeling-labs) (CML) is a network simulation platform from Cisco that allows for the creation of robust network topologies made up of nearly anything you can imagine. It supports virtual machine based devices using QCOW or KVM format, and can be tied into physical components by "bridging" the simulation to the real world.
|
||||
@@ -14,34 +14,39 @@ CML is officially supported on bare-metal x86\_64 servers and in VMware ESXi and
|
||||
Unofficially, CML can be installed onto [HyperV](documentation/cml_on_hyperv.md), [Proxmox](documentation/cml_on_proxmox.md),
|
||||
and [Nutanix AHV](documentation/cml_on_nutanix.md).
|
||||
|
||||
This repository is intended to be a place for the CML community to find and share content that builds on top of the standard CML installation. Examples of this content include:
|
||||
This repository is intended to be a place for the CML community to find and share content that builds on top of the standard CML installation. Examples of this content include:
|
||||
|
||||
### Node and Image Definition Files
|
||||
Included with CML is a library of ["reference platforms"](https://developer.cisco.com/docs/modeling-labs/#!reference-platforms-and-images) for a variety of Cisco network devices as well as images for Linux servers, traffic generators, unmanaged devices, etc. However, CML allows a "bring your own image" model for any KVM supported image. While we **cannot** share the actual QCOW image files for nodes that require proper licensing and rights from individual platform owners, we can post the CML YAML file definitions that have been created to support different platforms from Cisco as well as third party vendors.
|
||||
|
||||
The folder structure of this repository reflect the folder structure and naming conventions used on the CML server itself for storing the definitions.
|
||||
Included with CML is a library of ["reference platforms"](https://developer.cisco.com/docs/modeling-labs/#!reference-platforms-and-images) for a variety of Cisco network devices as well as images for Linux servers, traffic generators, unmanaged devices, etc. However, CML allows a "bring your own image" model for any KVM supported image. While we **cannot** share the actual QCOW image files for nodes that require proper licensing and rights from individual platform owners, we can post the CML YAML file definitions that have been created to support different platforms from Cisco as well as third party vendors.
|
||||
|
||||
The folder structure of this repository reflect the folder structure and naming conventions used on the CML server itself for storing the definitions.
|
||||
|
||||
* [node-definitions](node-definitions) - Folder containing YAML file definitions for a CML node. The YAML file includes details on how the VM would be configured (ie CPU, RAM, Network Adapters, etc).
|
||||
* [virl-base-images](virl-base-images) - Folder containing a folder for each added platform disk image. Within each platform folder you will find a YAML file that references a specific `disk_image` file for a platform. A base image definition will reference a node definition.
|
||||
* *Note: You will need to download the disk images from the vendors yourself.*
|
||||
* **Note: You will need to download the disk images from the vendors yourself.**
|
||||
|
||||
When deciding how many total resources you need to use CML, consult the [CML Sizing Calculator](documentation/cml_sizing_calculator.xlsx).
|
||||
|
||||
### Sample Lab Topologies
|
||||
|
||||
### Sample Lab Topologies
|
||||
CML includes a series of Sample Labs that are available from the Tools menu in Lab Manager, however these are just a start of the possible network simulations that can be created. Within this repository users of CML can find, or share, network topologies that have been created to highlight a specific type of simulation challenge.
|
||||
|
||||
> Note: Sample Lab Topologies from this repository may leverage nodes that are **NOT** included with the standard reference platform for CML. Be sure to look at the requirements for any given lab topology.
|
||||
> Note: Sample Lab Topologies from this repository may leverage nodes that are **NOT** included with the standard reference platform for CML. Be sure to look at the requirements for any given lab topology.
|
||||
|
||||
## DevNet Sandbox
|
||||
|
||||
A great way to make your repo easy for others to use is to provide a link to a [DevNet Sandbox](https://developer.cisco.com/site/sandbox/) that provides a network or other resources required to use this code. In addition to identifying an appropriate sandbox, be sure to provide instructions and any configuration necessary to run your code with the sandbox.
|
||||
|
||||
If you are new to Cisco Modeling Labs, you can explore and test drive CML within [DevNet Sandbox](https://developer.cisco.com/site/sandbox/). Just search for "Cisco Modeling" from the Sandbox Catalog.
|
||||
If you are new to Cisco Modeling Labs, you can explore and test drive CML within [DevNet Sandbox](https://developer.cisco.com/site/sandbox/). Just search for "Cisco Modeling" from the Sandbox Catalog.
|
||||
|
||||

|
||||

|
||||
|
||||
## Getting help
|
||||
|
||||
Instruct users how to get help with this code; this might include links to an issues list, wiki, mailing list, etc.
|
||||
|
||||
**Example**
|
||||
### Example
|
||||
|
||||
If you have questions, concerns, bug reports, etc., please create an issue against this repository.
|
||||
|
||||
|
BIN
documentation/cml_sizing_calculator.xlsx
Normal file
BIN
documentation/cml_sizing_calculator.xlsx
Normal file
Binary file not shown.
14
scripts/README.md
Normal file
14
scripts/README.md
Normal file
@@ -0,0 +1,14 @@
|
||||
# Cisco Modeling Labs (CML) Scripts
|
||||
|
||||
This directory contains various scripts designed to assist with using Cisco Modeling Labs (CML). These scripts can help automate tasks, manage labs, and streamline your workflow with CML.
|
||||
|
||||
Feel free to explore the scripts and refer to their individual documentation or comments for usage instructions.
|
||||
|
||||
## Other Useful Scripts Hosted Elsewhere
|
||||
|
||||
In addition to the scripts in this directory, you may find the following external resources helpful:
|
||||
|
||||
- [eve2cml](https://github.com/CiscoDevNet/eve2cml) - An EVE-NG to CML lab topology conversion tool written in Python
|
||||
- [cml-exporter](https://github.com/xorrkaz/cml-exporter) - A Prometheus exporter for CML written in Python
|
||||
|
||||
These repositories contain additional scripts and examples for automating and managing CML environments.
|
Submodule scripts/eve2cml deleted from a1402eeddb
@@ -1,26 +1,27 @@
|
||||
# CML Use Cases
|
||||
# Cisco Modeling Labs (CML) Use Cases
|
||||
|
||||
This directory consists of Git submodules for other repositories that contain uses cases for CML and build off of
|
||||
CML's powerful REST API (and Python Client Library).
|
||||
This directory contains curated use cases for Cisco Modeling Labs (CML). Each use case demonstrates practical scenarios, workflows, or solutions that can be implemented using CML.
|
||||
|
||||
## Using
|
||||
## Use Cases in This Repository
|
||||
|
||||
By default, git doesn't pull down the submodules content. You can cause it to clone all of the submodules by doing the
|
||||
following:
|
||||
- Explore the subdirectories for available use cases hosted here.
|
||||
|
||||
```sh
|
||||
git submodule init
|
||||
git submodule update
|
||||
```
|
||||
## External Use Cases
|
||||
|
||||
If you haven't yet cloned the `cml-community` repo, you can use the following command to clone it and pull down all the
|
||||
submodules:
|
||||
The following use cases are not hosted in this repository but may be useful:
|
||||
|
||||
```sh
|
||||
git clone --recuse-submodules https://github.com/CiscoDevNet/cml-community
|
||||
```
|
||||
- [cml-class-automation](https://github.com/CiscoDevNet/cml-class-automation) - Proof of concept on how one can automate Cisco Modeling Labs in order to deliver networking courses using virtual labs.
|
||||
- [cml-cicd](https://github.com/CiscoDevNet/cml-cicd) - Example on using CML within a CI/CD pipeline.
|
||||
- [dst-automation](https://github.com/CiscoDevNet/dst-automation) - Automate the deployment and testing of Dynamic Split Tunneling on a Cisco ASA firewall within CML.
|
||||
- [cmlutils](https://github.com/CiscoDevNet/virlutils) - A collection of utilities for interacting with Cisco Modeling Labs (CML).
|
||||
- [ansible-cml](https://github.com/CiscoDevNet/ansible-cml) - Ansible Modules for CML.
|
||||
- [sdwan-devops](https://github.com/CiscoDevNet/sdwan-devops) - SD-WAN DevOps Tools built around CML.
|
||||
- [ciscolive-brkcrt-2059](https://github.com/CiscoLearning/ciscolive-brkcrt-2059) - Lab Up For Success With Cisco Modeling Labs.
|
||||
- [cloud-cml](https://github.com/CiscoDevNet/cloud-cml) - Run Cisco Modeling Labs on cloud infrastructure.
|
||||
|
||||
## Contributing
|
||||
|
||||
If you have a Git repo (doesn't even have to be on GitHub) that contains a use case for CML, submit a pull request or
|
||||
issue to get it added. We'd love to see how you're using CML.
|
||||
If you wish to submit a use case, you can either create a pull request to host it here in this repository, or you can submit a pull request
|
||||
for this `README.md` alone that points to your CML use cases hosted elsewhere.
|
||||
|
||||
Feel free to contribute new use cases or suggest additional resources!
|
||||
|
Submodule use-cases/ansible-cml deleted from 2406a0d8bf
Submodule use-cases/cloud-cml deleted from 15c8e5b21e
Submodule use-cases/cml-cicd deleted from 1a7083901c
Submodule use-cases/cml-class-automation deleted from 56ef511b80
Submodule use-cases/dst-automation deleted from dffcde76f1
Submodule use-cases/sdwan-devops deleted from aa17ca0f5c
Submodule use-cases/virlutils deleted from 41fe98e2d8
Reference in New Issue
Block a user