Note: Please go to docs.rightscale.com to access the current RightScale documentation set. Also, feel free to Chat with us!
Home > Guides > Dashboard Users Guide > Design > Macros > Actions > Create a New Macro

Create a New Macro

Note: Macros are available only in LCP. Macros have been deprecated and are not available in the Unified Cloud Platform.

Objective

To create a new macro.  (The example shown is for a deployment, but the mechanics are the same for arrays, servers, etc.)

Table of Contents

Overview

Macros are a powerful feature of the RightScale Dashboard. Macros let users save and then rapidly re-create a copy of a deployment, server array, or server—including user-defined input values and other parameters. You can modify macros you have created, or create an empty macro and customize it.

Note: Currently, you can use macros in Amazon EC2 environments only, and they do not set inputs (attributes) for Chef recipes.

When you sign up for a free RightScale account and add your Amazon EC2 credentials, you can automatically launch one of RightScale's preconfigured deployments (a basic LAMP server running a Rails application, WordPress blog, or Trac application). This process runs a RightScale-created macro.

For information on creating custom macros, see Macro Reference Documentation.

Steps

Navigation

To create a macro, go to Design -> Macros and click New

Select the Macro Type

Select the type of macro you wish to create from the menu. Choose one these options:

  • Deployment - Creates a copy of a deployment, except Elastic IPs (if any) and the nickname of the deployment. When you run a macro, it will create these new components for you and prompt you to provide names for each.
  • Array - Creates the array itself and creates a duplicate security group, ssh_key, audit queue(s), and indicator queue(s).
  • Server - Creates a copy of a server, except the SSH key, security group, Elastic IP (if any), and the nickname.
  • Existing Macro - Creates a clone of an existing macro.
  • Create New - Creates a new "EmptyMacro" that you can edit directly.
     

Select the specific object in the corresponding drop-down menu that you wish to create a macro from.

screen-NewMacro-v1.png

After making your selection, click Create.

Note: A warning message displays if you are creating a macro for a deployment that uses a private ServerTemplate, because it cannot be run under a different account. Partners who wish to publish and share macros must remember that users will be unable to launch servers using private ServerTemplates because they do not have access to them. A ServerTemplate's assigned permissions always take precedence over a macro's permissions.

By default, the new macro name will include the name of the source, and a timestamp.  The example below shows a deployment macro.

screen-ShowMacro-v1.png

 

You must to post a comment.
Last modified
09:39, 22 Jan 2014

Tags

Classifications

This page has no classifications.

Announcements

None


© 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.