Description

Application cookbook for installing the Netflix Ice AWS usage
and cost reporting application.

Requirements

Chef 11.4.0+ and Ohai 6.10+ for platform_family use.

This cookbook requires attributes be set based on the instructions for
configuring the Netflix Ice application.

You will also need to enable Amazon's programmatic billing access to
receive detailed billing reports.

The following cookbooks are dependencies:

• apt (on ubuntu)
• openssl
• java
• tomcat
• nginx
• artifact (Riot Games)

Platform:

Tested on

• Ubuntu 12.04
• Centos 6.4

Other Debian and RHEL family distributions are assumed to work.

Attributes

• node['ice']['version'] - Ice version to download and install. These versions are packaged and hosted by Medidata Solutions until we can get the Netflix Ice team to package and host official ice releases.
• node['ice']['checksum'] - Checksum for Ice WAR file.
• node['ice']['war_url'] - HTTP URL for Ice WAR file.
• node['ice']['force_redeploy'] - Will force a redeploy of the Ice WAR file.
• node['ice']['company_name'] - Organization name that is displayed in the UI header.
• node['ice']['processor']['enabled'] - Enables the Ice processor.
• node['ice']['processor']['local_dir'] - Local work directory for the Ice processor.
• node['ice']['billing_aws_access_key_id'] - AWS access key id used for accessing AWS detailed billing files from S3.
• node['ice']['billing_secret_key'] - AWS secret key used for accessing AWS detailed billing files from S3.
• node['ice']['billing_s3_bucket_name'] - Name of the S3 bucket containing the AWS detailed billing files.
• node['ice']['billing_s3_bucket_prefix'] - Directory in the S3 billing bucket containing AWS detailed billing files.
• node['ice']['work_s3_bucket_name'] - Name of the S3 bucket that Ice uses for processed AWS detailed billing files. This bucket is shared between the Ice processor and reader.
• node['ice']['work_s3_bucket_prefix'] - Directory in the S3 work bucket containing the processed AWS detailed billing files.
• node['ice']['reader']['enabled'] - Enables the Ice reader and installs the Nginx reverse proxy.
• node['ice']['reader']['local_dir'] - Local work directory for the Ice reader.
• node['ice']['start_millis'] - Specify the start time in milliseconds for the processor to start processing billing files.
• node['ice']['public_hostname'] - Optional. Fully qualified domain name used for configuring the Nginx reverse proxy on Ice readers/UI nodes.
• node['ice']['accounts'] - Optional. Hash mapping of AWS account names to account numbers. This is used within Ice to give accounts human readable names in the UI.

Usage

This recipe allows you to deploy Netflix Ice as a standalone node running both the
processor and reader or as seperate nodes running a processor and a reader which is the
deployment layout that the Netflix Ice team recommends.

Here is a sample role for creating an Ice processor node:
YAML
chef_type: role
default_attributes:
description:
env_run_lists:
json_class: Chef::Role
name: ice-processor
override_attributes:
ice:
billing_aws_access_key_id: YOURAWSKEYID
billing_aws_secret_key: YOURAWSSECRETKEY
billing_s3_bucket_name: ice-billing
version: 0.0.2
war_url: https://s3.amazonaws.com/ice-app
checksum: c5f0c31d8493783814c017a2af575e8d8fa1855359008b868621823381d61d6a
skip_manifest_check: false
company_name: Company Name
force_deploy: false
processor:
enabled: true
reader:
enabled: false
start_millis: 1357016400000
work_s3_bucket_name: ice-work
tomcat:
catalina_options: -Xmx1024M -Xms1024M
run_list:
recipe[ice]


Here is a sample role for creating an Ice reader node:
YAML
chef_type: role
default_attributes:
description:
env_run_lists:
json_class: Chef::Role
name: ice-reader
override_attributes:
ice:
billing_aws_access_key_id: YOURAWSKEYID
billing_aws_secret_key: YOURAWSSECRETKEY
billing_s3_bucket_name: ice-billing
version: 0.0.2
war_url: https://s3.amazonaws.com/ice-app
checksum: c5f0c31d8493783814c017a2af575e8d8fa1855359008b868621823381d61d6a
skip_manifest_check: false
company_name: Company Name
force_deploy: false
processor:
enabled: false
reader:
enabled: true
start_millis: 1357016400000
work_s3_bucket_name: ice-work
tomcat:
catalina_options: -Xmx1024M -Xms1024M
run_list:
recipe[ice]


Author

• Author: Ray Rodriguez
• Author: Benton Roberts