Import/Export
Importing and exporting data to and from Flipt
Both flipt import
and flipt export
support the --address
and --token
flags to enable transferring data to and from Flipt instances via the API instead of requiring a direct database connection.
flipt import --address http://flipt.my.org --token static-api-token
flipt export --address grpc://flipt.my.org:9000
Both HTTP
and gRPC
are supported by the --address
flag.
Import
To import data into Flipt, use the flipt import
command. You can either import from a file or from STDIN.
To import from STDIN, Flipt requires the --stdin
flag:
cat flipt.yaml | flipt import --stdin
If not importing using --stdin
, Flipt requires the file to be imported as an argument:
flipt import flipt.yaml
Namespaces are inferred from the YAML documents themselves. If a namespace your document refers to doesn’t exist in the database, it will be created.
This command supports the --drop
flag that will drop all data in your Flipt database tables before importing. This is to ensure that no data collisions occur during the import.
Be careful when using the --drop
flag as it will immediately drop all data
and there is no undo. It’s recommended to first backup your database before
running this command just to be safe.
See the CLI reference for more information on the import
command.
Export
To export Flipt data, use the flipt export
command.
By default, export
will output to STDOUT:
$ flipt export
flags:
- key: new-contact-page
name: New Contact Page
description: Show users our Beta contact page
enabled: true
variants:
- key: blue
name: Blue
- key: green
name: Green
You can also export to a file using the -o filename
or --output filename
flags:
flipt export -o flipt.yaml
By default, Flipt will export from the default
namespace. Use the flag --namespaces
to export from a different namespace or multiple namespaces.
flipt export --namespaces production
The --all-namespaces
flag is a boolean flag that tells export to export all
namespaces.
See the CLI reference for more information on the export
command.
Was this page helpful?