Project

General

Profile

Actions

User story #21247

closed

Add an API endpoint to export rules, directives, techniques, groups and their dependencies in an archive

Added by François ARMAND almost 2 years ago. Updated almost 2 years ago.

Status:
Released
Priority:
N/A
Assignee:
-
Category:
API
Target version:
UX impact:
Suggestion strength:
User visibility:
Effort required:
Name check:
To do
Fix check:
To do
Regression:

Description

Add an API endpoint that would export rules and their dependencies: directives, techniques (with resources), groups.
Add the corresponding endpoint to import the same things (or a sub-set of that).

Part of the user story is to define the serialization format.
We want to use an archive, likely zip because of its wide availability, of files organized in directory by type that mimic content of /var/rudder/config-repo

We want to use a similar format too.
There is a question around revision since it does not have meaning out of the context of a Rudder, but may be important for understand things afterward. A middle ground could be to export it in archive, but ignore it in import (since we can't import things at a given revision, just on a branch).

Serialisation should be easely human updatable, even with long text. Yaml is a good candidate. A first version can use another format, as long as the feature is put behind a feature flag that needs to be enabled so that people are informed that the format is not definitive.

EDIT: this first user story will only be for exporting archive of items with (optionaly) their dependencies.
We use json for now, but would like to be able to change the format latter on, so we will put the feature behind a feature switch.
A second user story for the opposite action (import zip archive with json serialized objects) will be added as a subtask.


Subtasks 3 (0 open3 closed)

User story #21315: Add revision to node groupsReleasedVincent MEMBRÉActions
User story #21321: Add API endpoint to import an archive of rules/etcResolvedVincent MEMBRÉActions
User story #21394: Missing API documentation for import/export policies with dependenciesReleasedVincent MEMBRÉActions

Related issues 4 (1 open3 closed)

Related to Rudder - User story #21675: User documentation of archive import/exportReleasedElaad FURREEDANActions
Related to Rudder - Enhancement #22333: Avoid sync group when importing a rule archiveReleasedVincent MEMBRÉActions
Related to Rudder - Enhancement #22342: Add a "all" keyword for export API in place of listing UUIDs of rule/directive/etcNewActions
Related to Rudder - User story #5738: Export and import (create, update) Rule with all dependencies ResolvedActions
Actions

Also available in: Atom PDF