CFConfig Documentation
Search…
Introduction
Using the CLI
Using the Services
Transfer Settings
Transfer configuration from one location/server to another. If you don't specify a from or to, we look for a CommandBox server using the current working directory. Only rely on this if you have a single CommandBox server running in the current directory. You must specify at least a
from or a to.Note the two servers do not need to be the same kind. CFConfig will translate the config for you.
1
cfconfig transfer from=servername to=anotherServername
2
cfconfig transfer from=serverName
3
cfconfig transfer to=serverName
4
cfconfig transfer from=/path/to/server/home to=/path/to/another/server/home
5
cfconfig transfer from=/path/to/server/home
6
cfconfig transfer to=/path/to/server/home
Copied!
All the same rules for engine format and version apply.
1
cfconfig transfer from=/path/to/.CFConfig.json to=/path/to/server/home [email protected]
Copied!
The version number can be left off
toFormat and fromFormat when reading or writing to a CFConfig JSON file or a CommandBox server since we already know the version. If you don't specify a Lucee web or Server context, we default to server. Use a format of luceeWeb to switch.IncludeList and excludeList
You can customize what config settings are transferred with the includeList and excludeList params. If at least one include pattern is provided, ONLY matching settings will be included. Nested keys such as datasources.myDSN or mailservers[1] can be used. You may also use basic wildcards in your pattern. A single will match any number of chars inside a key name. A double * will match any number of nested keys.
1
# Include all settings starting with "event"
2
cfconfig transfer from=.CFConfig.json includeList=event*
3
# Exclude all keys called "password" regardless of what struct they are in
4
cfconfig transfer from=.CFConfig.json excludeList=**.password
Copied!
Append flag
Use the append parameter to merge incoming data with any data already present. For example, if a server already has one datasource defined and you import a JSON file with 2 more unique datasources, the --append flag will not remove the pre-existing one.
1
cfconfig transfer from=.CFConfig.json includeList=datasources --append
Copied!
JSON Expansion Replacements
If you usually replace sensitive or volatile information in a JSON export with env var expansions like
${DB_PASSWORD}, you can do this automatically my supplying one or more replace mappings. The key is a regular expression to match a key in the format of datasources.myDSN.password and the value is the name of the env var to use. The values will be written to a .env file in the current working directory. You can override this path with the dotenvFile param, or pass an empty string to disable it from being written.1
cfconfig transfer to=.CFConfig.json replace:datasources\.myDSN\.password=DB_PASSWORD
Copied!
As the value is a regular expression, you can use backreferences like
\1 in your env var to make them dynamic.
This example would create env vars such as DB_MYDSN_PASSWORD where MYDSN is your actual datasource name.1
cfconfig tranfser to=.CFConfig.json replace:datasources\.(.*)\.password=DB_\1_PASSWORD
Copied!
Any valid regex is possible for some clever replacements. This example would create env vars such as
DB_MYDSN_PORT, DB_MYDSN_HOST, and DB_MDSN_DATABASE1
cfconfig tranfser to=.CFConfig.json replace:datasources\.(.*)\.(password|class|port|host|database)=DB_\1_\2 dotenvFile=../../settings.properties
Copied!
To avoid having to pass these replacements every time you transfer your config, you can set then as a global setting for the
commandbox-cfconfig module.1
# Replace all mail server passwords with ${MAIL_PASSWORD}
2
config set modules.commandbox-cfconfig.JSONExpansions[mailServers.*.password]=MAIL_PASSWORD
3
# Dynamically replace with ${DB_MYDSN_password}, ${DB_MYDSN_CLASS}, ${DB_MYDSN_PORT}, etc
4
config set modules.commandbox-cfconfig.JSONExpansions[datasources\.(.*)\.(password|class|port|host|database)]=DB_\1_\2
5
# Use default env var name for all settings starting with "requestTimeout" and replace with ${REQUEST_TIMEOUT} and ${REQUEST_TIMEOUT_ENABLED}
6
config set modules.commandbox-cfconfig.JSONExpansions[requestTimeout.*]=
Copied!
Note, the
config set syntax shown above require at least CommandBox 5.4.0Last modified 6mo ago
Copy link
Edit on GitHub