Package: fabfed-py
Table of contentsDescriptionInstallationOperation InstructionsDescriptionThe FabFed is a Python library for a cross-testbed federation framework that (1) models the network experiment (or "slice") across the FABRIC testbed and federated testbeds and providers, and (2) provides workflow tools to stitch l2 and l3 networks between the testbeds and providers.The FabFed code took the initial form from the Mobius API, and refactored and reinvented the slice modeling, user interface, data structure and  stitching workflows.The example below showcases network stitching across providers, achiprovider and afabricprovider. The configuration, while incomplete, highlights how fabfed-py expresses dependencies.For more details, refer to fabfed'sworkflow designFor a complete example, refer toFabric Chameleon Stitching1 resource:
  2
  3   - network:
  4       - chi_network:
  5             provider: '{{ chi.chi_provider }}'
  6             site: CHI@UC
  7
  8   - network:
  9       - fabric_network:
 10            provider: '{{ fabric.fabric_provider }}'
 11            site: 'STAR'
 12            stitch_with: '{{ network.chi_network }}'InstallationFabFed is available at PyPI.pip install fabfed-pyAlternatively, you may install and test using the following commands:pip install -e .
fabfed --help
fabfed stitch-policy --help
fabfed workflow --help
fabfed sessions --helpIf using the CloudLab provider, the following portal-tools module is a required dependency:pip install git+https://gitlab.flux.utah.edu/stoller/portal-tools.gitOperation InstructionsFabfed worflow configuration is specified across one or more.fabfiles. Fabfed does not care how these files  are named. Fabfed simply loads all the .fab configuration files, assembles them and parses the assembled configuration.Fabfed will pickup any file ending with the.fabextension in the directory specified by
the--config-dir.  If this option is not present, the current directory is used.The --var-file option can be used to override the default value of any variable. It consists of a set of key-value pairs with each pair written askey: value. At runtime, all variables found in an assembled configuration must have a value other thanNone. The parser will halt and throw an exeption otherwise.The --session is a friendly name used to track a given workflow.Use the --help options shown above if in doubt.When stitching networks across provider usestitch-policyto discover available stitch information# Example to view stitch policy from cloudlab to fabric
fabfed stitch-policy -providers "fabric,cloudlab"

fabfed workflow --config-dir some_dir [--var-file some_var_file.yml] --session some_session -validate

fabfed workflow --config-dir some_dir [--var-file some_var_file.yml] --session some_session -init [-summary] [-json]

fabfed workflow --config-dir some_dir [--var-file some_var_file.yml] --session some_session -plan [-summary] [-json]

fabfed workflow --config-dir some_dir [--var-file some_var_file.yml] --session some_session -apply

fabfed workflow --config-dir some_dir [--var-file some_var_file.yml] --session some_session -show [-summary] [-json]

fabfed workflow --config-dir some_dir [--var-file some_var_file.yml] --session some_session -destroy

# Use this option to manage your workflow sessions
fabfed sessions -show