Copyright (c) 2006-2014 MindTouch Inc.
This file and accompanying files are licensed under the MindTouch Master Subscription Agreement (MSA).
At any time, you shall not, directly or indirectly: (i) sublicense, resell, rent, lease, distribute, market, commercialize or otherwise transfer rights or usage to: (a) the Software, (b) any modified version or derivative work of the Software created by you or for you, or (c) MindTouch Open Source (which includes all non-supported versions of MindTouch-developed software), for any purpose including timesharing or service bureau purposes; (ii) remove or alter any copyright, trademark or proprietary notice in the Software; (iii) transfer, use or export the Software in violation of any applicable laws or regulations of any government or governmental agency; (iv) use or run on any of your hardware, or have deployed for use, any production version of MindTouch Open Source; (v) use any of the Support Services, Error corrections, Updates or Upgrades, for the MindTouch Open Source software or for any Server for which Support Services are not then purchased as provided hereunder; or (vi) reverse engineer, decompile or modify any encrypted or encoded portion of the Software.
A complete copy of the MSA is available at http://www.mindtouch.com/msa
Each Chef cookbook must contain two metadata files:
The RightScale platform uses Chef metadata to determine what's inside of a Chef cookbook and how its recipes and attributes (inputs) should be used. If a recipe or attribute (input) is not properly defined in the cookbook's metadata.json file, it does not exist from RightScale's point of view. Therefore, it's extremely important that you properly configure your metadata.rb so that all of the cookbook's components are discoverable and usable as expected in the RightScale platform.
A common mistake for many Chef developers is forgetting to update the metadata.rb file with properly formatted information about a new recipe or attribute (input), so that the new script and input appear to be missing and are not displayed as expected in the dashboard.
RightScale relies on a cookbook's metadata to compute the given inputs for each recipe. The screenshot below shows how the content of a cookbook's metadata.rb is used to display the related input information in the dashboard (assuming that the metadata.json file matches the metadata.rb file). Click to enlarge.
Note: There is a size limit of 64KB on the metadata file that can be generated in cookbooks.
You must update the metadata correctly whenever you add a new recipe or attribute, otherwise the script and/or inputs will not be visible or usable within the RightScale platform. To learn how to properly construct a metadata.rb file, see Update Cookbook Metadata Files.
Click the link below to view an example of a properly constructed metadata.rb file that follows RightScale's best practices.
No. After the 2013-10-01 Dashboard release, you are no longer required to manually generate the metadata.json file for each cookbook because RightScale will automatically generate the .json file (from the metadata.rb file) each time a cookbook is fetched or refetched into Repose. However, RightScale still uses the metadata.json file to determine how a cookbook should be represented in the RightScale platform. For this reason, it's very important that each of your cookbooks has a properly formatted metadata.rb file. If there is a problem in a cookbook's metadata.rb file and RightScale is unable to generate the associated metadata.json file, you will have problems using the cookbook in the RightScale platform. As a result, you might not be able to see a recipe and/or add it to a ServerTemplate. Or perhaps an input is not being displayed as a user-configurable parameter under the Inputs tab. If there is an error scraping cookbooks from a repository and the metadata.json files cannot be generated, an error message will be displayed under the Repository object's Info tab.
Important! If cookbook contains a metadata.json file, it will be used as-is and RightScale will not generate a new metadata.json file or override/replace the existing one. It's perfectly acceptable you choose to keep existing metadata.json files in an existing cookbook, especially if you are not actively making changes to the cookbook. However, since RightScale now generates the metadata.json file for a cookbook, you might want to change your developer workflows accordingly to remove this unnecessary step.
|Glossary | 用語 | 용어||Site Map | Site Help||Community||Corporate Site||Get Support||Dashboard Login|
|Doc Feedback||Product Feedback||Resources||MultiCloud Marketplace||Forums|
© 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.