cookbook 'aws', '= 2.1.0'
aws
(106) Versions
2.1.0
-
-
9.1.6
-
9.1.5
-
9.1.4
-
9.1.3
-
9.1.2
-
9.1.1
-
9.1.0
-
9.0.16
-
9.0.15
-
9.0.14
-
9.0.13
-
9.0.12
-
9.0.11
-
9.0.10
-
9.0.9
-
9.0.8
-
9.0.7
-
9.0.6
-
9.0.5
-
9.0.4
-
9.0.3
-
9.0.2
-
9.0.1
-
9.0.0
-
8.4.1
-
8.4.0
-
8.3.1
-
8.3.0
-
8.2.0
-
8.1.1
-
8.1.0
-
8.0.4
-
8.0.3
-
8.0.2
-
8.0.1
-
8.0.0
-
7.5.0
-
7.4.0
-
7.3.1
-
7.3.0
-
7.2.2
-
7.2.1
-
7.2.0
-
7.1.2
-
7.1.1
-
7.1.0
-
7.0.0
-
6.1.1
-
6.1.0
-
6.0.0
-
5.0.1
-
5.0.0
-
4.2.2
-
4.2.1
-
4.2.0
-
4.1.3
-
4.1.2
-
4.1.1
-
4.1.0
-
4.0.0
-
3.4.1
-
3.4.0
-
3.3.3
-
3.3.2
-
3.3.1
-
3.3.0
-
3.2.0
-
3.1.0
-
3.0.0
-
2.9.3
-
2.9.2
-
2.9.1
-
2.9.0
-
2.8.0
-
2.7.2
-
2.7.1
-
2.7.0
-
2.6.6
-
2.6.5
-
2.6.4
-
2.6.3
-
2.6.2
-
2.6.1
-
2.6.0
-
2.5.0
-
2.4.0
-
2.3.0
-
2.2.2
-
2.2.0
-
2.1.1
-
2.1.0
-
2.0.0
-
1.0.0
-
0.101.6
-
0.101.4
-
0.101.2
-
0.101.0
-
0.100.6
-
0.100.4
-
0.100.2
-
0.100.0
-
0.99.1
-
0.99.0
-
0.10.1
-
0.10.0
-
0.9.0
Follow271
- 9.1.6
- 9.1.5
- 9.1.4
- 9.1.3
- 9.1.2
- 9.1.1
- 9.1.0
- 9.0.16
- 9.0.15
- 9.0.14
- 9.0.13
- 9.0.12
- 9.0.11
- 9.0.10
- 9.0.9
- 9.0.8
- 9.0.7
- 9.0.6
- 9.0.5
- 9.0.4
- 9.0.3
- 9.0.2
- 9.0.1
- 9.0.0
- 8.4.1
- 8.4.0
- 8.3.1
- 8.3.0
- 8.2.0
- 8.1.1
- 8.1.0
- 8.0.4
- 8.0.3
- 8.0.2
- 8.0.1
- 8.0.0
- 7.5.0
- 7.4.0
- 7.3.1
- 7.3.0
- 7.2.2
- 7.2.1
- 7.2.0
- 7.1.2
- 7.1.1
- 7.1.0
- 7.0.0
- 6.1.1
- 6.1.0
- 6.0.0
- 5.0.1
- 5.0.0
- 4.2.2
- 4.2.1
- 4.2.0
- 4.1.3
- 4.1.2
- 4.1.1
- 4.1.0
- 4.0.0
- 3.4.1
- 3.4.0
- 3.3.3
- 3.3.2
- 3.3.1
- 3.3.0
- 3.2.0
- 3.1.0
- 3.0.0
- 2.9.3
- 2.9.2
- 2.9.1
- 2.9.0
- 2.8.0
- 2.7.2
- 2.7.1
- 2.7.0
- 2.6.6
- 2.6.5
- 2.6.4
- 2.6.3
- 2.6.2
- 2.6.1
- 2.6.0
- 2.5.0
- 2.4.0
- 2.3.0
- 2.2.2
- 2.2.0
- 2.1.1
- 2.1.0
- 2.0.0
- 1.0.0
- 0.101.6
- 0.101.4
- 0.101.2
- 0.101.0
- 0.100.6
- 0.100.4
- 0.100.2
- 0.100.0
- 0.99.1
- 0.99.0
- 0.10.1
- 0.10.0
- 0.9.0
Provides resources for managing AWS resources
cookbook 'aws', '= 2.1.0', :supermarket
knife supermarket install aws
knife supermarket download aws
Description
This cookbook provides libraries, resources and providers to configure
and manage Amazon Web Services components and offerings with the EC2
API. Currently supported resources:
- EBS Volumes (
ebs_volume
) - EBS Raid (
ebs_raid
) - Elastic IPs (
elastic_ip
) - Elastic Load Balancer (
elastic_lb
) - AWS Resource Tags (
resource_tag
)
Unsupported AWS resources that have other cookbooks include but are
not limited to:
Note This cookbook uses the right_aws
RubyGem to interact with
the AWS API because at the time it was written, fog
and aws-sdk
were not available. Further, both of those gems require nokogiri
which requires compiling native extensions, which means build tools
are required. We do not plan at this time to change the underlying
Ruby library used in order to limit the external dependencies for
this cookbook.
Requirements
Requires Chef 0.7.10 or higher for Lightweight Resource and Provider
support. Chef 0.8+ is recommended. While this cookbook can be used in
chef-solo
mode, to gain the most flexibility, we recommend using
chef-client
with a Chef Server.
An Amazon Web Services account is required. The Access Key and Secret
Access Key are used to authenticate with EC2.
AWS Credentials
In order to manage AWS components, authentication credentials need to
be available to the node. There are 2 way to handle this:
1. explicitly pass credentials parameter to the resource
2. or let the resource pick up credentials from the IAM role assigned to the instance
Using resource parameters
To pass the credentials to the resource, credentials should be available to the node.
There are a number of ways to handle this, such as node attributes or Chef roles.
We recommend storing these in a databag (Chef 0.8+), and loading them in the recipe where the
resources are needed.
DataBag recommendation:
% knife data bag show aws main
{
"id": "main",
"aws_access_key_id": "YOUR_ACCESS_KEY",
"aws_secret_access_key": "YOUR_SECRET_ACCESS_KEY"
}
This can be loaded in a recipe with:
aws = data_bag_item("aws", "main")
And to access the values:
aws['aws_access_key_id']
aws['aws_secret_access_key']
We'll look at specific usage below.
Using IAM instance role
If your instance has an IAM role, then the credentials can be automatically resolved by the cookbook
using Amazon instance metadata API.
You can then omit the resource parameters aws_secret_access_key
and aws_access_key
.
Of course, the instance role must have the required policies. Here is a sample policy for EBS volume
management:
json
{
"Version": "2012-10-17",
"Statement": [
{
"Action": [
"ec2:AttachVolume",
"ec2:CreateVolume",
"ec2:ModifyVolumeAttribute",
"ec2:DescribeVolumeAttribute",
"ec2:DescribeVolumeStatus",
"ec2:DescribeVolumes",
"ec2:DetachVolume",
"ec2:EnableVolumeIO"
],
"Sid": "Stmt1381536011000",
"Resource": [
"*"
],
"Effect": "Allow"
}
]
}
For resource tags:
json
{
"Version": "2012-10-17",
"Statement": [
{
"Action": [
"ec2:CreateTags"
],
"Sid": "Stmt1381536708000",
"Resource": [
"*"
],
"Effect": "Allow"
}
]
}
Recipes
default.rb
The default recipe installs the right_aws
RubyGem, which this
cookbook requires in order to work with the EC2 API. Make sure that
the aws recipe is in the node or role run_list
before any resources
from this cookbook are used.
"run_list": [
"recipe[aws]"
]
The gem_package
is created as a Ruby Object and thus installed
during the Compile Phase of the Chef run.
Libraries
The cookbook has a library module, Opscode::AWS::Ec2
, which can be
included where necessary:
include Opscode::Aws::Ec2
This is needed in any providers in the cookbook. Along with some
helper methods used in the providers, it sets up a class variable,
ec2
that is used along with the access and secret access keys
Resources and Providers
This cookbook provides two resources and corresponding providers.
ebs_volume.rb
Manage Elastic Block Store (EBS) volumes with this resource.
Actions:
-
create
- create a new volume. -
attach
- attach the specified volume. -
detach
- detach the specified volume. -
snapshot
- create a snapshot of the volume. -
prune
- prune snapshots.
Attribute Parameters:
-
aws_secret_access_key
,aws_access_key
- passed toOpscode::AWS:Ec2
to authenticate required, unless using IAM roles for authentication. -
size
- size of the volume in gigabytes. -
snapshot_id
- snapshot to build EBS volume from. - most_recent_snapshot - use the most recent snapshot when creating a volume from an existing volume (defaults to false)
-
availability_zone
- EC2 region, and is normally automatically detected. -
device
- local block device to attach the volume to, e.g./dev/sdi
but no default value, required. -
volume_id
- specify an ID to attach, cannot be used with action:create
because AWS assigns new volume IDs -
timeout
- connection timeout for EC2 API. -
snapshots_to_keep
- used with action:prune
for number of snapshots to maintain. -
description
- used to set the description of an EBS snapshot -
volume_type
- "standard" or "io1" (io1 is the type for IOPS volume) -
piops
- number of Provisioned IOPS to provision, must be >= 100 -
existing_raid
- whether or not to assume the raid was previously assembled on existing volumes (default no)
ebs_raid.rb
Manage Elastic Block Store (EBS) raid devices with this resource.
Attribute Parameters:
-
aws_secret_access_key
,aws_access_key
- passed toOpscode::AWS:Ec2
to authenticate, required. -
mount_point
- where to mount the RAID volume -
mount_point_owner
- the owner of the mount point (default root) -
mount_point_group
- the group of the mount point (default root) -
mount_point_mode
- the file mode of the mount point (default 0755) -
disk_count
- number of EBS volumes to raid -
disk_size
- size of EBS volumes to raid -
level
- RAID level (default 10) -
filesystem
- filesystem to format raid array (default ext4) -
snapshots
- array of EBS snapshots to restore. Snapshots must be taken using an ec2 consistent snapshot tool, and tagged with a number that indicates how many devices are in the array being backed up (e.g. "Logs Backup [0-4]" for a four-volume raid array snapshot) -
disk_type
- "standard" or "io1" (io1 is the type for IOPS volume) -
disk_piops
- number of Provisioned IOPS to provision per disk, must be > 100
elastic_ip.rb
Actions:
-
associate
- associate the IP. -
disassociate
- disassociate the IP.
Attribute Parameters:
-
aws_secret_access_key
,aws_access_key
- passed toOpscode::AWS:Ec2
to authenticate, required, unless using IAM roles for authentication. -
ip
- the IP address. -
timeout
- connection timeout for EC2 API.
elastic_lb.rb
Actions:
-
register
- Add this instance to the LB -
deregister
- Remove this instance from the LB
Attribute Parameters:
-
aws_secret_access_key
,aws_access_key
- passed toOpscode::AWS:Ec2
to authenticate, required, unless using IAM roles for authentication. -
name
- the name of the LB, required.
resource_tag.rb
Actions:
-
add
- Add tags to a resource. -
update
- Add or modify existing tags on a resource -- this is the default action. -
remove
- Remove tags from a resource, but only if the specified values match the existing ones. -
force_remove
- Remove tags from a resource, regardless of their values.
Attribute Parameters
-
aws_secret_access_key
,aws_access_key
- passed toOpscode::AWS:Ec2
to authenticate, required, unless using IAM roles for authentication. -
tags
- a hash of key value pairs to be used as resource tags, (e.g.{ "Name" => "foo", "Environment" => node.chef_environment }
,) required. -
resource_id
- resources whose tags will be modified. The value may be a single ID as a string or multiple IDs in an array. If noresource_id
is specified the name attribute will be used.
Usage
The following examples assume that the recommended data bag item has
been created and that the following has been included at the top of
the recipe where they are used.
include_recipe "aws"
aws = data_bag_item("aws", "main")
aws_ebs_volume
The resource only handles manipulating the EBS volume, additional
resources need to be created in the recipe to manage the attached
volume as a filesystem or logical volume.
aws_ebs_volume "db_ebs_volume" do
aws_access_key aws['aws_access_key_id']
aws_secret_access_key aws['aws_secret_access_key']
size 50
device "/dev/sdi"
action [ :create, :attach ]
end
This will create a 50G volume, attach it to the instance as /dev/sdi
.
aws_ebs_volume "db_ebs_volume_from_snapshot" do
aws_access_key aws['aws_access_key_id']
aws_secret_access_key aws['aws_secret_access_key']
size 50
device "/dev/sdi"
snapshot_id "snap-ABCDEFGH"
action [ :create, :attach ]
end
This will create a new 50G volume from the snapshot ID provided and
attach it as /dev/sdi
.
aws_elastic_ip
The elastic_ip
resource provider does not support allocating new
IPs. This must be done before running a recipe that uses the resource.
After allocating a new Elastic IP, we recommend storing it in a
databag and loading the item in the recipe.
Databag structure:
% knife data bag show aws eip_load_balancer_production
{
"id": "eip_load_balancer_production",
"public_ip": "YOUR_ALLOCATED_IP"
}
Then to set up the Elastic IP on a system:
ip_info = data_bag_item("aws", "eip_load_balancer_production")
aws_elastic_ip "eip_load_balancer_production" do
aws_access_key aws['aws_access_key_id']
aws_secret_access_key aws['aws_secret_access_key']
ip ip_info['public_ip']
action :associate
end
This will use the loaded aws
and ip_info
databags to pass the
required values into the resource to configure. Note that when
associating an Elastic IP to an instance, connectivity to the instance
will be lost because the public IP address is changed. You will need
to reconnect to the instance with the new IP.
You can also store this in a role as an attribute or assign to the
node directly, if preferred.
aws_elastic_lb
elastic_lb
opererates similar to `elastic_ip'. Make sure that you've
created the ELB and enabled your instances' availability zones prior
to using this provider.
For example, to register the node in the 'QA' ELB:
aws_elastic_lb "elb_qa" do
aws_access_key aws['aws_access_key_id']
aws_secret_access_key aws['aws_secret_access_key']
name "QA"
action :register
end
aws_resource_tag
resource_tag
can be used to manipulate the tags assigned to one or
more AWS resources, i.e. ec2 instances, ebs volumes or ebs volume
snapshots.
Assigning tags to a node to reflect it's role and environment:
aws_resource_tag node['ec2']['instance_id'] do
aws_access_key aws['aws_access_key_id']
aws_secret_access_key aws['aws_secret_access_key']
tags({"Name" => "www.example.com app server",
"Environment" => node.chef_environment})
action :update
end
Assigning a set of tags to multiple resources, e.g. ebs volumes in a
disk set:
aws_resource_tag 'my awesome raid set' do
aws_access_key aws['aws_access_key_id']
aws_secret_access_key aws['aws_secret_access_key']
resource_id [ "vol-d0518cb2", "vol-fad31a9a", "vol-fb106a9f", "vol-74ed3b14" ]
tags({"Name" => "My awesome RAID disk set",
"Environment" => node.chef_environment})
end
Note If you would like to use the normal attribute
node['aws']['ebs_volume']['db_ebs_volume']['volume_id']
generated by the
aws_ebs_volume resource examples above as input for the resource_id attribute of
the aws_resource_tag resource, you must employ the "lazy" attribute feature
from Chef 10.28 or Chef 11.x and higher. "lazy" will delay the
evaluation of the resource_id attribute's value until the normal/set node attribute is
available.
aws_resource_tag "db_ebs_volume" do resource_id lazy { node['aws']['ebs_volume']['db_ebs_volume']['volume_id'] } tags ({"Service" => "Frontend"}) end
aws_s3_file
s3_file
can be used to download a file from s3 that requires aws authorization. This
is a wrapper around remote_file
and supports the same resource attributes as remote_file
.
aws_s3_file "/tmp/foo" do
bucket "i_haz_an_s3_buckit"
remote_path "path/in/s3/bukket/to/foo"
aws_access_key_id aws['aws_access_key_id']
aws_secret_access_key aws['aws_secret_access_key']
end
License and Author
- Author:: Chris Walters (cw@opscode.com)
- Author:: AJ Christensen (aj@opscode.com)
- Author:: Justin Huff (jjhuff@mspin.net)
Copyright 2009-2013, Opscode, Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Dependent cookbooks
This cookbook has no specified dependencies.