Table of Contents
Once you have completed the initial development of a custom ServerTemplate and either release it for use in production environments within your own RightScale account or publish a revision of it to the MultiCloud Marketplace (MCM), you may need to regularly maintain the ServerTemplate over time. This document highlights some of the common procedures that may be required to keep your ServerTemplate up-to-date.
In the diagram above, several ServerTemplate revisions were published. In this example, Rev 3 is a newer revision of a previously published ServerTemplate (Rev 1). Both revisions are of the same ServerTemplate. However, when you clone a component, it creates a completely new object with a different lineage. Therefore, the published Rev 2 version of the cloned ServerTemplate is technically a revision of a completely different ServerTemplate. Yellow/orange ball updates are only displayed when newer revisions of the same ServerTemplate are published and made available.
If your custom ServerTemplate is based on another ServerTemplate that you previously imported from the MultiCloud Marketplace you may want to import the newer version (if available) and incorporate some of those updates into your own custom ServerTemplate.
For example, if you started your development with an application ServerTemplate published by RightScale and several months later RightScale releases an updated version of that ServerTemplate that includes a few bug fixes and security enhancements, you may want to incorporate those changes into your custom version of that ServerTemplate. In such cases, you may want to import the newest revision that was published to the MCM, perform a differential (diff) to identify the changes and perhaps merge those changes into the HEAD version of your cloned ServerTemplate. Of course, it's always recommended that you test the ServerTemplate after you've made changes to it, especially if you're merging changes that might not be compatible.
If you previously published a ServerTemplate and now want to replace it with a newer version in the MultiCloud Marketplace, you may want to deprecate any previously published revisions before you publish the new version.
If a newer revision of a RightScript (of the same lineage) is available, you will see an orange ball icon next to the script name. Notifications are only displayed for RightScripts, not Chef recipes. An orange icon will be displayed for one of two reasons:
Note: Yellow/orange icons will only be displayed if you're viewing an editable HEAD version since you cannot update RightScripts on a committed, static revision of a ServerTemplate.
Click the orange icon to perform a differential between the two revisions of the script and view the changes. If the newer revision is available in the MCM and is currently not available in the RightScale account, you will have the option to import it from the MCM. (The Import button will only be displayed if you have 'library' user role privileges in the RightScale account.)
If you wish to change a RightScript's revision, click the Edit icon next to the script name.
You can also update a RightScript revision across multiple ServerTemplates within a RightScale account to perform a global upgrade of a particular RightScript.
If you are updating a ServerTemplate's MCIs, it's recommended that you test each MCI by launching test servers into each of the supported clouds. If you modify the list of MCIs by either updating the revision of an existing MCI or adding new MCIs to the list, you are responsible for testing and maintaining the ServerTemplate. The publisher of the ServerTemplate is no longer responsible because you are introducing new functionality that was not originally supported when it was published.
If you are developing new ServerTemplates, it's strongly recommended that you use the most recent revisions of MCIs that are available. If you are following best practices and using MCIs published by RightScale, it's recommended that you keep the revisions of the existing MCIs up-to-date if they are of the same compatibility release (e.g. 12H1). For example, if RightScale releases newer revisions of MCIs that your ServerTemplate is currently using, it's recommended that you update your ServerTemplate's MCI list to use the latest revisions, which often include bug fixes, security improvements, and updated cloud support.
Although it is possible to change the ServerTemplate of a server, it's recommended that you only perform this action in a development or test environment and not in a live production environment.
As a best practice, alert specifications that are associated with monitored server metrics should be defined at the ServerTemplate level. An alert specification either uses an Alert Escalation or sets a voter tag (for autoscaling purposes).
You can either update existing alert specifications, create new ones, or import them from another source (RightScale's default alerts, ServerTemplate, or server). Any changes to a ServerTemplate's Alerts tab can be identified by performing a ServerTemplate differential. Be sure to review the best practices for adding alert specifications to a ServerTemplate.
© 2006-2014 RightScale, Inc. All rights reserved.
RightScale is a registered trademark of RightScale, Inc. All other products and services may be trademarks or servicemarks of their respective owners.