Tungsten Fabric is an open source network virtualization solution for providing connectivity and security for virtual, containerized or bare-metal workloads.
Tungsten Fabric supports integrations with the following orchestrators:
Openstack
Kubernetes
Openshift
vCenter
BYOO [Bring your own orchestrator]
Tungsten Fabric is a part of the Linux Foundation Networking Fund, a project of the Linux Foundation.
Deploy Tungsten Fabric in 15 minutes on AWS with Kubernetes
Deploy Tungsten Fabric on Kubernetes in 1-step command - Centos
Deploy Tungsten Fabric on Kubernetes in 1-step command - Ubuntu
Deploy Tungsten Fabric On-Prem with Openstack
Tungsten Fabric Detailed Architecture Document
Tungsten Fabric Detailed Architecture Document (Simplified Chinese)
Whether you want to fix a typo in comments or introduce a brand new feature, there are a few steps which make the process smoother:
Create a Linux Foundation ID, if you don't have one yet. You'll need this to subscribe to the mailing lists and to access the bugs and blueprints.
Subscribe to the dev@lists.tungsten.io mailing list. If you wish, there are also several other mailing lists you can join as well.
The wiki currently contains legal and technical docs, event decks and similar resources to boost your understanding of Tungsten Fabric. This material will eventually be moving to the wiki or Git repositories.
Join Slack. Post your questions to relevant channels, don't abuse @here, get help and help others. The mailing list works best for long-running discussions; Slack is great for ad-hoc conversations.
Before you push anything, you'll need to sign a Contributor License Agreement or CLA: either Individual CLA (ICLA) if you are an independent contributor, or Corporate CLA (CCLA). We suggest you sign a CCLA if you are employed at a company which pays you for your Tungsten Fabric-related work. CCLA also simplifies things if your teammates plan to contribute as well. Both ICLA and CCLA are legal documents. Please read them carefully. It's usually smart to run the document past your company's legal department before signing and submitting it, if only to verify that your contribution will be within your company's policy. You can find all ICLA/CCLA documents in the Tungsten Fabric CLA Wiki.
If you've found a bug, file a bug report against the respective release in Jira. Be sure to describe both expected and actual behavior. You'll need the bug ID later, so please do this even if you feel the change is trivial.
If you plan to develop a new feature, you must create or provide three things:
Although contrail-specs and other Tungsten Fabric repositories are hosted on GitHub, they are managed with Gerrit. Please don't send Pull Requests to the GitHub repositories, and go to https://review.opencontrail.org instead. Blueprint specs are submitted this way as well.
Note that Tungsten Fabric is currently migrating from Juniper owned https://review.opencontrail.org to [https://github.com/tungstenfabric/] email discuss@lists.tungsten.io for the latest information.
After getting Gerrit access as described below, clone the specs repository
with the command:
git clone https://review.opencontrail.org/Juniper/contrail-specs
and install the git-review extension which will allow you to submit specs as
well as code changes. In order to write a spec, start by copying the template
blueprint_template.md
to a meaningful name in the appropriate subdirectory
for the release that you would like to target.
With all of these in place, you are now ready to submit your specs and code to Tungsten Fabric! How to write these specs and code is a different story though, but we hope the links in the next section will help you to get started. You may also want to consult a more detailed how-to available here, in the contrail-community-docs repo. And of course, feel free to ask questions on the mailing list and in Slack channels!
NOTE: The columns and dates below are subject to change. An effort is still underway to reconcile Tungsten Fabric processes and previously established Juniper practices with respect to Contrail development timelines.
Release | Blueprint Due | Specification Due | Dev Complete | GA Release |
---|---|---|---|---|
5.0 | 2018-04-23 | |||
5.0.1 | 2018-07-16 | |||
5.1 | 2018-07-15 | 2018-08-22 | TBD | Q1 2019 |