Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status

RSS

cassandra-priam (4) Versions 0.1.3

Installs Priam-managed Cassandra

Policyfile
Berkshelf
Knife
cookbook 'cassandra-priam', '~> 0.1.3', :supermarket
cookbook 'cassandra-priam', '~> 0.1.3'
knife supermarket install cassandra-priam
knife supermarket download cassandra-priam
README
Dependencies
Quality 33%

Description

This cookbook exists to achieve a deployment of a Priam Managed Cassandra Cluster.

This cookbook elects a leader to create the necessary SimpleDB databases/configuration entries to manage the deployment along with some Priam/Cassandra configuration Properties managed via chef attributes.

Priam is a sidecar application that takes care of Cassandra Configuration, Startup, Seeding and Node Replacement, Backups (to s3) and Restoration (from s3). It makes the lifecycle of Cassandra clusters much easier to manage.

Some scripts have been included if you want to interrogate/configure simpledb directly - see the examples/scripts/simpledb directory.

This cookbook installs the JNA package.

Special Caveats:

This cookbook and the software it deploys are only designed to work under AWS EC2 with Autoscaling and SimpleDB.

You should check that the credentials you provide have the necessary accesss to use the relevant AWS services.

General Caveats:

Java:

The software this cookbook installs has mostly been tested with the Oracle JRE - your mileage may vary on other JRE builds.

SimpleDB:

Contact Amazon to get your SimpleDB limits increased moderately with your usage.

Cluster, Role and Autoscaling Group Naming

When creating a cluster, there are several places where the reference must be identical/matching for things to work as expected.

These references should ideally all be the same and globally unique - although some are suffixed with identifiers, and some are not that global (security groups are regional).

Dashes are a used as a separator, so we try and use underscores where possible.

Use the following as a guide / concept for your own naming:

Autoscaling Group Name : unique_cassandra_cluster_one-useast1

Note that we indicate the region the group is in at the end of the name with a dash separator.

Role Name : unique-cassandra-cluster-one | unique_cassandra_cluster_one

This must be unique within the chef API, shared between all members members of the cluster.

Cluster Name : unique_cassandra_cluster_one

If a cluster name is not configured directly we will make one out of the role name, replacing dashes (-) with underscores (_)

Security Group Name : unique_cassandra_cluster_one

Priam will attempt to configure security groups itself in each region if it is in multiregion mode. It will not however create them : They should be created matching the cluster name (i.e. the ASG name before the region suffix).

See the ec2/autoscaling commands at the bottom of this document for a clearer picture of some of the implications.

AWS Credentials:

This cookbook tries to pick up AWS credentials from an encrypted databag by default in the same location as the ebs cookbook and others use (bag: credentials item: aws). See the attributes for more information.

Requirements

Platform

  • Ubuntu 12.04+ [tested heavily]
  • Probably other Linux Distros with some tweaking of package names where appropriate.

Note: This cookbook does not call any package managers directly but rather through the chef package resource, but package names and installation paths may differ.

Attributes

See the contents of attributes/default.rb where there are accurate comments and self-explanatory attribute names.

Recipes

  • default.rb : A dummy recipe pointing to install.rb
  • install.rb : Installs everything by calling the rest of the recipes in the right order. Includes a leadership election section for applying simpledbconfig
  • awscredentials.rb : Creates AWS Credentials on the /etc filesystem
  • cassandra.rb : Installs Cassandra
  • optimizations.rb : Applies Optimizations to limits.d
  • priam.rb : Installs Priam
  • simpledbconfig.rb : Applies SimpleDB configuration

Usage

Include cassandra-priam in your unique role's runlist.

The following example variables should be in the unique role's "overrides" attributes section:

singleregion:

{
  "cassandra": {
    "priam_s3_bucket": "YOURORG-cassandra-backups",
  },
  "tomcat":{
     "base_version": "7"
  },
  "authorization": {
    "sudo": {
      "include_sudoers_d": "true"
    }
  },
  "java": {
    "install_flavor": "oracle",
    "jdk_version": "7",
    "oracle": {
      "accept_oracle_download_terms": "true"
    }
  }
}

multiregion:

{
  "cassandra": {
    "priam_s3_bucket": "YOURORG-cassandra-backups",
    "priam_multiregion_enable": "true",
    "priam_endpoint_snitch": "org.apache.cassandra.locator.Ec2MultiRegionSnitch",
    "priam_zones_available": "us-east-1a,us-east-1b,us-east-1c,us-west-1a,us-west-1b,us-west-1c",
  },
  "tomcat":{
     "base_version": "7"
  },
  "authorization": {
    "sudo": {
      "include_sudoers_d": "true"
    }
  },
  "java": {
      "install_flavor": "oracle",
      "jdk_version": "7",
      "oracle" : {
        "accept_oracle_download_terms": "true"
      }
   }
}

Putting It Together with Autoscaling Commands

singleregion

as-create-launch-config unique_cassandra_cluster_one-useast1 --region us-east-1 --image-id ami-a73264ce --instance-type m1.small --monitoring-disabled --group unique-cassandra-cluster-name --key aws_ssh_keypair_id --user-data-file chefregistrationetc.txt
as-create-auto-scaling-group unique_cassandra_cluster_one-useast1 --region us-east-1 --launch-configuration unique_cassandra_cluster_name-useast1 --max-size 4 --min-size 2 --availability-zones us-east-1a,us-east-1b,us-east-1c

multiregion

ec2-create-group --region us-east-1 unique_cassandra_cluster_two -d unique_cassandra_cluster_two
ec2-create-group --region us-west-1 unique_cassandra_cluster_two -d unique_cassandra_cluster_two
as-create-launch-config unique_cassandra_cluster_two-useast1 --region us-east-1 --image-id ami-a73264ce --instance-type m1.small --monitoring-disabled --group unique_cassandra_cluster_two --key aws_ssh_keypair_id --user-data-file chefregistrationetc.txt 
as-create-launch-config unique_cassandra_cluster_two-uswest1 --region us-west-1 --image-id ami-acf9cde9 --instance-type m1.small --monitoring-disabled --group unique_cassandra_cluster_two --key aws_ssh_keypair_id --user-data-file chefregistrationetc.txt
as-create-auto-scaling-group unique_cassandra_cluster_two-useast1 --region us-east-1 --launch-configuration unique_cassandra_cluster_two-useast1 --max-size 4 --min-size 2 --availability-zones us-east-1a,us-east-1b,us-east-1c
as-create-auto-scaling-group unique_cassandra_cluster_two-uswest1 --region us-west-1 --launch-configuration unique_cassandra_cluster_two-uswest1 --max-size 4 --min-size 2 --availability-zones us-west-1a,us-west-1b,us-west-1c

Development

See the Github page

Authors

Copyright: 2013–2013 Medidata Solutions, Inc.
Copyright: 2014- Alex Trull

Dependent cookbooks

sudo >= 0.0.0
runit >= 0.0.0
java >= 0.0.0
tomcat >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

Collaborator Number Metric
            

0.1.3 failed this metric

Failure: Cookbook has 1 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric
            

0.1.3 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Foodcritic Metric
            

0.1.3 failed this metric

FC064: Ensure issues_url is set in metadata: cassandra-priam/metadata.rb:1
FC065: Ensure source_url is set in metadata: cassandra-priam/metadata.rb:1
FC066: Ensure chef_version is set in metadata: cassandra-priam/metadata.rb:1
FC069: Ensure standardized license defined in metadata: cassandra-priam/metadata.rb:1
FC075: Cookbook uses node.save to save partial node data to the chef-server mid-run: cassandra-priam/recipes/install.rb:39
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric
            

0.1.3 passed this metric

Testing File Metric
            

0.1.3 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric
            

0.1.3 passed this metric