Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat: add documentation for changes to import/export functionality #124

Merged
merged 7 commits into from
Oct 2, 2023

Conversation

yquansah
Copy link
Contributor

Documentation for the new changes to the import/export functionality.

This change talks about the breaking changes in mdx Notes. The reason being that the previously existing documentation for import and export will still be relevant for some time due to people not being updated to the latest Flipt.

Completes FLI-617

@yquansah yquansah requested a review from a team as a code owner September 28, 2023 17:43
@@ -50,6 +50,15 @@ For convenience, you can supply `--create-namespace` in order for Flipt to autom
flipt import --namespace production --create-namespace flipt.yaml
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i wonder if we should just remove the section on --create-namespace and the section about how the namespace must exist now?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@markphelps Yeah I battled with this. I am for it, just was curious how many people are version upgrade averse.


The `--namespaces` flag will accept a comma delimited list of namespaces from which you would like to export from.

The `--all-namespaces flag is a boolean flag which tells export to export all namespaces to the single file you specify, or to standard out by default.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The `--all-namespaces flag is a boolean flag which tells export to export all namespaces to the single file you specify, or to standard out by default.
The `--all-namespaces` flag is a boolean flag that tells export to export all namespaces to the single file you specify, or to standard out by default.


The `--namespace` flag is now deprecated, and two new flags now exist.

The `--namespaces` flag will accept a comma delimited list of namespaces from which you would like to export from.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The `--namespaces` flag will accept a comma delimited list of namespaces from which you would like to export from.
The `--namespaces` flag will accept a comma-delimited list of namespaces from which you would like to export from.

<Note>
In [v1.28.0](https://github.com/flipt-io/flipt/releases/tag/v1.28.0), we have extended this functionality to support exporting state from multiple namespaces to a single YAML file.

The `--namespace` flag is now deprecated, and two new flags now exist.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The `--namespace` flag is now deprecated, and two new flags now exist.
The `--namespace` flag is now deprecated.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This reminds me, we need to add this change to our https://github.com/flipt-io/flipt/blob/main/DEPRECATIONS.md file

@markphelps markphelps added the pending release waiting on release of Flipt label Sep 28, 2023
@markphelps markphelps merged commit 66acbee into main Oct 2, 2023
3 checks passed
@markphelps markphelps deleted the import-export-docs branch October 2, 2023 16:03
@markphelps markphelps removed the pending release waiting on release of Flipt label Dec 28, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants