Modifying a fabric intent

The Fabric Services System provides a number of methods to alter a fabric intent. Options vary depending on whether a fabric intent has been saved, generated, or deployed.

Editing a fabric intent

You can edit the parameters for a fabric intent that you have previously saved or generated, but not yet deployed. Editing in this way does not create a new version of the fabric intent; the version number is not set, and changes do not increment the version number until you deploy the current fabric intent.

When editing a fabric intent, you cannot change the template that the fabric intent design is based on, but you can alter the description and topology-related values such as the number of leaves and spines. When you begin the edit operation, the system makes clear which fields can be altered and which cannot.

When you deploy a fabric intent, you can no longer edit its parameters. You must create a new version of a deployed fabric intent as described in Creating a new version of a fabric intent, at which point you can save, regenerate, and possibly redeploy the new version.

To edit a saved fabric intent:

  1. Open the saved fabric intent as described in Viewing a fabric intent.
  2. Edit parameters in the left panel as required.
  3. When you are finished editing parameters, click to save the new configuration.

Effect of edits on a related backbone intent

As described in Backbone fabrics, a fabric intent may fall within a hierarchical structure under a related backbone intent. When this is the case, any changes you make to a fabric intent must be propagated to the "parent" backbone fabric intent to keep the two descriptions of the same fabric synchronized.

When you modify a flexible leaf/spine fabric intent, the system marks the related backbone intent as "stale". You must resolve this state by manually creating and deploying a new candidate version for that backbone intent.

You do not need to make any changes to the backbone intent during this operation; simply creating a new version and deploying it causes the system to update the backbone intent with the latest version of the participating fabric intents.

Discarding changes to a fabric intent

After you create a new version of a fabric intent, but before you deploy it, you can discard the changes you have made. This deletes the new version of the fabric intent entirely, and reverts the display show to the previously deployed version.

If you discard changes for the initial version of a fabric intent that was never deployed, it deletes the fabric intent entirely.

To discard changes for any version of a fabric intent:

  1. Open the fabric intent as described in Viewing a fabric intent.
  2. From the opened fabric intent, click the More actions icon () at the upper right of the page.
  3. Select Discard Changes.
  4. Click OK.
    The system deletes the current, in-progress candidate version of the fabric intent, and the display reverts to show the last-deployed version.

Creating a new version of a fabric intent

After a fabric intent has been deployed, you can still revise its design. This creates a new, incremented version of the previously deployed fabric intent, which you can alter without affecting the currently deployed version. When you are ready, you can deploy the new version of the fabric intent to replace the previous version.

Some actions you perform in the system may require a change to the configurations of one or more fabrics. When this happens, the system may automatically create, save, and generate a new version of the affected fabric intents for you. You can then deploy the new version to apply the necessary configuration changes to the affected nodes.

A new version of a fabric intent keeps the same fabric intent name, but the system assigns an incremented version number, date, and (if necessary) a new user association.

Creating a new fabric intent is also a prerequisite for some operations that are not supported on the initial version of a fabric intent. Currently, the operations that are supported only on Version 2.0 or greater of a fabric intent are:

To create a new version of an existing fabric intent:

  1. Open the fabric intent as described in Viewing a fabric intent.
  2. Click the menu at the upper right of the page.
  3. Select Create Candidate Version.
    The system saves a new version of the current fabric intent.

    You can now edit the fabric intent's parameters and save the result without affecting the original version.

  4. Click GENERATE FABRIC to generate a new fabric diagram.
    You can now view the fabric intent, and eventually add it to the deployment pipeline and deploy it as you would for a new fabric intent.

    At any time before deploying the new version, you can discard this candidate version and revert to the previously deployed version by clicking on the More actions icon ( ) in the Fabric Design view and selecting Discard Changes.

Duplicating a fabric intent

In addition to saving new, incremental versions of an existing fabric intent, you can save a completely independent copy of an existing intent. This new duplicate has its own version history that you can continue to develop independently of the original.

To duplicate a fabric intent:

  1. Open the list of fabric intents as described in Viewing a fabric intent.
  2. Click the More actions icon () at the right end of the row.
  3. Select Duplicate from the action list.
The system creates a new, independent copy (not a new version) of the selected fabric intent.