Google Cloud Storage Cookbook LWRP

Description

This cookbook provides libraries, resources and providers to configure
and manage Google Cloud Storage
components. The currently supported
GCS resources are:

• bucket (bucket)
• object (object)

Requirements

Requires fog ruby gem to interact with GCS.

Authorizing Setup

In order to use the Google Cloud Storage cookbook, you will first need to have
a Google Cloud project. Once your
project has been created, log in to the Google Developers Console and select your project. From
the Google Developers Console, on the left side of the page, click "APIs
& auth" then the "Credentials" sub menu. At the bottom of the page,
click "Return to original console". This will redirect you to the "Google APIs
Console". From the new menu on the left side of the page, click on "Google
Cloud Storage" Unless you've already enabled "Interoperable Access" you'll see
a button towards the bottom of the page. Click that button to enable
"Interoperable Access". Finally, click the new "Interoperable Access" sub menu
on the left side of the page. Your "Interoperable Storage Access Keys" will
now be listed.

    % knife data bag show gcs credentials 
    {
      "access_key_id": "AABBCCDDEE",
      "secret_access_key": "abcdefg23456789+0"
    }

This can be loaded in a recipe with:

    gcs = data_bag_item("gcs", "credentials")

And to access the values:

    gcs['access_key_id']
    gcs['secret_access_key']

Resources and Providers

This cookbook provides a resource and corresponding provider.

object.rb

Manage GCS objects with this resource.

Actions:

• get - download an object.
• put - upload an object.
• delete - delete object.
• copy - copy an object from one bucket to another.

bucket.rb

Manage GCS buckets with this resource.

Actions:

• put - create a bucket.
• delete - delete a bucket.

Usage

object create

This will copy a local file to GCS with default private permissions set.

    gcs_object "my_file" do
      access_key_id gcs['access_key_id']
      secret_access_key gcs['secret_access_key']
      bucket_name "my_bucket"
      local_path "/path/to/my_file"
      action :put
    end

object copy

This will copy an object from one bucket to another. By default,
the target object name will be the same as source unless specified
with the optional target_bucket_name.

    gcs_object "my_file" do
      access_key_id gcs['access_key_id']
      secret_access_key gcs['secret_access_key']
      source_bucket_name "my_bucket"
      target_bucket_name "my_other_bucket"
      action :copy
    end

License and Authors

• Author:: Paul Rossman (paulrossman@google.com)

Copyright 2014, Google, 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.