Export a snapshot

Export a snapshot to generate config data for the pipeline to use.

Before you begin

Important:

Starting with the Washington D.C. release, DevOps Config is being prepared for future deprecation. It will be hidden and no longer activated on new instances but will continue to be supported.

• The cdm_secrets role is required to export snapshots that include encrypted data.
• The cdm_viewer can export any snapshot that does not include encrypted data.
• The cdm_exporter_editor can create, edit, publish, activate, and delete exporters.

Role required: cdm_exporter_editor or cdm_editor or cdm_admin

About this task

• Exporters in the content pack have the Source value of ServiceNow. You can duplicate, but cannot delete or modify content pack exporters.
• You can execute only active published exporters.
• For export, snapshots cannot exceed 10,000 config data items (CDIs) per deployable or 100,000 CDIs per application.
• Records of exporter executions are deleted after a period of three years. For instructions on changing the default time period, see Set the purge period for records of exporter executions.

Procedure

1. Select the admin icon () to open the Administration page.
2. On the Exporters tab, select the name of the exporter.
   Tip:

   Add commonly used exporters to the My Exporters list for quick access.
   The Versions tab for the exporter opens, displaying the list of draft and published versions of the exporter.
3. Select a published version of the exporter to run.
   The exporter opens on the Exporter Builder tab. The text of the exporter script appears in a view-only panel. Use the Test playground panel to specify the snapshot to export and test settings before you export the config data.
4. Specify the settings for the exporter execution on the Select inputs page.

   Table 1. Test playground settings

   Field	Description
   Deployable and published snapshot to export	Deployable for export and the particular published snapshot that you have validated and want to use. Deployables appear in the list using the format <AppName/DeployableName>. When you select a deployable, another field lists all published snapshots for the deployable. The most recently published snapshot appears first in the list. Select the snapshot to export.
   Input arguments	The arguments that the exporter script uses to generate config data as output. The text box displays the default values for all arguments. Update values as needed.
   Output format	Format in which to generate the config data.
   Additional deployables	Deployables for which to generate config data in addition to the primary deployable that you specified in the Deployable and published snapshot to export field. Only the latest published snapshots appear for this optional setting.

5. Select Save to save your changes and then select Evaluate.
   The exporter script runs using the settings that you specified and then displays the resulting config data in the Output box on the Review output page.
6. Review the results.
   To make changes, select Select inputs, specify new settings, and then select Evaluate. Repeat as often as needed.

   Note:

   When you are satisfied that the exporter generates complete config data and follows the required output format standards, you can publish it and activate it.