Get started with YAML configuration
2 minute read
Prerequisites
- Install or upgrade an existing system to API Gateway version v7.7.0-20200930.
- Run client tools on a linux-based system.
- Before converting your XML federated configuration you must upgrade it using upgradeconfig or projupgrade.
Convert XML federated configuration to YAML
You must start with an existing XML federated configuration. If you do not have an existing XML federated configuration you can create a new one in Policy Studio using one of the factory templates.
If your project is called, for example, test
, then the XML files for it will exist in ~/apiprojects/test
. The federated URL is federated:file:/home/user/apiprojects/test/configs.xml
.
Note
Ensure that you have upgraded any old Policy Studio installation and your existing XML federated configuration to the latest version before converting it to YAML.If the XML federated configuration is encrypted with a passphrase, you do not need to decrypt it before or after the conversion to YAML. The converted YAML configuration will remain encrypted as all values are copied from one configuration to the other.
To convert your XML federated configuration to YAML:
-
Open a terminal and change directory to the API Gateway installation directory
apigateway/posix/bin
. -
Convert the XML to YAML:
./yamles fed2yaml -s /home/user/apiprojects/test -o /path/to/yamles
-
Validate the converted YAML configuration:
./yamles validate -s /path/to/yamles
For deployment to an API Gateway runtime, see Packaging and deployment.
For troubleshooting any errors, and more details on options and commands, see CLI Tool.
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.