2.3. Update a Profile
Atomic container upgrades
Normally, when you edit a profile that is already deployed in a container, the modification takes effect immediately. This is because the Fabric Agent in the affected container (or containers) actively monitors the fabric registry in real time.
In practice, however, immediate propagation of profile modifications is often undesirable. In a production system, you typically want to roll out changes incrementally: for example, initially trying out the change on just one container to check for problems, before you make changes globally to all containers. Moreover, sometimes several edits must be made together to reconfigure an application in a consistent way.
For quality assurance and consistency, it is typically best to modify profiles atomically, where several modifications are applied simultaneously. To support atomic updates, fabric implements profile versioning. Initially, the container points at version 1.0 of a profile. When you create a new profile version (for example, version 1.1), the changes are invisible to the container until you upgrade it. After you are finished editing the new profile, you can apply all of the modifications simultaneously by upgrading the container to use the new version 1.1 of the profile.
Upgrade to a new profile
For example, to modify the
quickstarts-beginner-camel.logprofile, when it is deployed and running in a container, follow the recommended procedure:
- Create a new version, 1.1, to hold the pending changes by entering this console command:
JBossFuse:karaf@root> fabric:version-create Created version: 1.1 as copy of: 1.0The new version is initialised with a copy of all of the profiles from version 1.0.
- Use the
fabric:profile-editcommand to change the message that is written to the container log by the Camel route. Enter the following
profile-editcommand to edit the
JBossFuse:karaf@root> fabric:profile-edit --resource camel.xml quickstarts-beginner-camel.log 1.1This opens the built-in text editor for editing profile resources (see Appendix A, Editing Profiles with the Built-In Text Editor).Remember to specify version
fabric:profile-editcommand, so that the modifications are applied to version 1.1 of the
quickstarts-beginner-camel.logprofile.When you are finished editing, type Ctrl-S to save your changes and then type Ctrl-X to quit the text editor and get back to the console prompt.
- Upgrade the
childcontainer to version
1.1by entering this console command:
JBossFuse:karaf@root> fabric:container-upgrade 1.1 child
Roll back to an old profile
You can easily roll back to the old version of the
quickstarts-beginner-camel.logprofile, using the
fabric:container-rollbackcommand like this:
JBossFuse:karaf@root> fabric:container-rollback 1.0 child