Overview

Cloud Storage is a fundamental resource in Google Cloud, with many advanced features. In this lab, you exercise many Cloud Storage features that could be useful in your designs. You can interact with Cloud Storage through the Google Cloud console, the command-line tool gsutil, or the Cloud Storage client libraries for various programming languages.

Objectives

In this lab, you learn how to perform the following tasks:

• Create and use buckets
• Set access control lists to restrict access
• Use your own encryption keys
• Implement version controls
• Use directory synchronization

Setup and Requirements

For each lab, you get a new Google Cloud project and set of resources for a fixed time at no cost.

1. Click the Start Lab button. If you need to pay for the lab, a pop-up opens for you to select your payment method. On the left is the Lab Details panel with the following:

   • The Open Google Cloud console button
   • Time remaining
   • The temporary credentials that you must use for this lab
   • Other information, if needed, to step through this lab

2. Click Open Google Cloud console (or right-click and select Open Link in Incognito Window if you are running the Chrome browser).

   The lab spins up resources, and then opens another tab that shows the Sign in page.

   Tip: Arrange the tabs in separate windows, side-by-side.

   Note: If you see the Choose an account dialog, click Use Another Account.

3. If necessary, copy the Username below and paste it into the Sign in dialog.

   {{{user_0.username | "Username"}}}

   You can also find the Username in the Lab Details panel.

4. Click Next.

5. Copy the Password below and paste it into the Welcome dialog.

   {{{user_0.password | "Password"}}}

   You can also find the Password in the Lab Details panel.

6. Click Next.

   Important: You must use the credentials the lab provides you. Do not use your Google Cloud account credentials. Note: Using your own Google Cloud account for this lab may incur extra charges.

7. Click through the subsequent pages:

   • Accept the terms and conditions.
   • Do not add recovery options or two-factor authentication (because this is a temporary account).
   • Do not sign up for free trials.

After a few moments, the Google Cloud console opens in this tab.

Note: To view a menu with a list of Google Cloud products and services, click the Navigation menu at the top-left, or type the service or product name in the Search field.

Task 1. Preparation

In the task, you create a Cloud Storage bucket. You then download a sample file which you will use in the next task.

Create a Cloud Storage bucket

1. In the Google Cloud console, in the Navigation menu (), click Cloud Storage > Buckets.

Note: A bucket must have a globally unique name. You could use part of your PROJECT_ID_1 in the name to help make it unique. For example, if the PROJECT_ID_1 is myproj-154920 your bucket name might be storecore154920

2. Click Create.
3. Specify the following, and leave the remaining settings as their defaults:

Property	Value (type value or select option as specified)
Name	Enter a globally unique name
Location type	Region
Region
Enforce public access prevention on this bucket	unchecked
Access control	Fine-grained (object-level permission in addition to your bucket-level permissions)

4. Make a note of the bucket name. It will be used later in this lab and referred to as [BUCKET_NAME_1].
5. Click Create.

Click Check my progress to verify the objective. Create a Cloud Storage bucket

Download a sample file using CURL and make two copies

1. In the Cloud console, click Activate Cloud Shell ().
2. If prompted, click Continue.
3. Store [BUCKET_NAME_1] in an environment variable:

export BUCKET_NAME_1=<enter bucket name 1 here>

4. Verify it with echo:

echo $BUCKET_NAME_1

5. Run the following command to download a sample file (this sample file is a publicly available Hadoop documentation HTML file):

curl \ https://hadoop.apache.org/docs/current/\ hadoop-project-dist/hadoop-common/\ ClusterSetup.html > setup.html

6. To make copies of the file, run the following commands:

cp setup.html setup2.html cp setup.html setup3.html

Task 2. Access control lists (ACLs)

In this task, you set access control lists to restrict access to the file that you copy to the Cloud Storage bucket.

Copy the file to the bucket and configure the access control list

1. Run the following command to copy the first file to the bucket:

gcloud storage cp setup.html gs://$BUCKET_NAME_1/

2. To get the default access list that's been assigned to setup.html, run the following command:

gsutil acl get gs://$BUCKET_NAME_1/setup.html > acl.txt cat acl.txt

3. To set the access list to private and verify the results, run the following commands:

gsutil acl set private gs://$BUCKET_NAME_1/setup.html gsutil acl get gs://$BUCKET_NAME_1/setup.html > acl2.txt cat acl2.txt

4. To update the access list to make the file publicly readable, run the following commands:

gsutil acl ch -u AllUsers:R gs://$BUCKET_NAME_1/setup.html gsutil acl get gs://$BUCKET_NAME_1/setup.html > acl3.txt cat acl3.txt

Click Check my progress to verify the objective. Make file publicly readable

Examine the file in the Cloud Console

1. In the Google Cloud console, in the Navigation menu (), click Cloud Storage > Buckets.
2. Click [BUCKET_NAME_1].
3. Verify that for file setup.html, Public access has a Public link available.

Delete the local file and copy back from Cloud Storage

1. Return to Cloud Shell. If necessary, click Activate Cloud Shell ().
2. Run the following command to delete the setup file:

rm setup.html

3. To verify that the file has been deleted, run the following command:

ls

4. To copy the file from the bucket again, run the following command:

gcloud storage cp gs://$BUCKET_NAME_1/setup.html setup.html

Task 3. Customer-supplied encryption keys (CSEK)

In this task, you generate a CSEK key to encrypt the files in stored in the Cloud Storage bucket.

Generate a CSEK key

For the next step, you need an AES-256 base-64 key.

1. Run the following command to create a key:

python3 -c 'import base64; import os; print(base64.encodebytes(os.urandom(32)))'

Result (this is example output):

b'tmxElCaabWvJqR7uXEWQF39DhWTcDvChzuCmpHe6sb0=\n'

2. Copy the value of the generated key excluding b' and \n' from the command output. Key should be in form of tmxElCaabWvJqR7uXEWQF39DhWTcDvChzuCmpHe6sb0=.

Modify the boto file

The encryption controls are contained in a gsutil configuration file named .boto.

1. To view and open the boto file, run the following commands:

ls -al nano .boto

Note: If the .boto file is empty, close the nano editor with Ctrl+X and generate a new .boto file using the gsutil config -n command. Then, try opening the file again with the above commands.

If the .boto file is still empty, you might have to locate it using the gsutil version -l command.

2. Locate the line with "#encryption_key="

Note: The bottom of the nano editor provides you with shortcuts to quickly navigate files. Use the Where Is shortcut to quickly locate the line with the #encryption_key=.

3. Uncomment the line by removing the # character, and paste the key you generated earlier at the end.

Example (this is an example):

Before: # encryption_key= After: encryption_key=tmxElCaabWvJqR7uXEWQF39DhWTcDvChzuCmpHe6sb0=

4. Press Ctrl+O, ENTER to save the boto file, and then press Ctrl+X to exit nano.

Upload the remaining setup files (encrypted) and verify in the Cloud Console

1. To upload the remaining setup.html files, run the following commands:

gsutil cp setup2.html gs://$BUCKET_NAME_1/ gsutil cp setup3.html gs://$BUCKET_NAME_1/

2. Return to the Cloud console.
3. Click [BUCKET_NAME_1]. Both setup2.html and setup3.html files show that they are customer-encrypted.

Click Check my progress to verify the objective. Customer-supplied encryption keys (CSEK)

Delete local files, copy new files, and verify encryption

1. To delete your local files, run the following command in Cloud Shell:

rm setup*

2. To copy the files from the bucket again, run the following command:

gsutil cp gs://$BUCKET_NAME_1/setup* ./

3. To cat the encrypted files to see whether they made it back, run the following commands:

cat setup.html cat setup2.html cat setup3.html

Task 4. Rotate CSEK keys

In this task, you rotate the CSEK used to encrypt data in Cloud Storage, ensuring continued data security.

Move the current CSEK encrypt key to decrypt key

1. Run the following command to open the .boto file:

nano .boto

2. Comment out the current encryption_key line by adding the # character to the beginning of the line.

Note: The bottom of the nano editor provides you with shortcuts to quickly navigate files. Use the Where Is shortcut to quickly locate the line with the encryption_key=.

3. Uncomment decryption_key1 by removing the # character, and copy the current key from the encryption_key line to the decryption_key1 line.

Result (this is example output):

Before: encryption_key=2dFWQGnKhjOcz4h0CudPdVHLG2g+OoxP8FQOIKKTzsg= # decryption_key1= After: # encryption_key=2dFWQGnKhjOcz4h0CudPdVHLG2g+OoxP8FQOIKKTzsg= decryption_key1=2dFWQGnKhjOcz4h0CudPdVHLG2g+OoxP8FQOIKKTzsg=

4. Press Ctrl+O, ENTER to save the boto file, and then press Ctrl+X to exit nano.

Note: In practice, you would delete the old CSEK key from the encryption_key line.

Generate another CSEK key and add to the boto file

1. Run the following command to generate a new key:

python3 -c 'import base64; import os; print(base64.encodebytes(os.urandom(32)))'

2. Copy the value of the generated key excluding b' and \n' from the command output. Key should be in form of tmxElCaabWvJqR7uXEWQF39DhWTcDvChzuCmpHe6sb0=.
3. To open the boto file, run the following command:

nano .boto

4. Uncomment encryption and paste the new key value for encryption_key=.

Result (this is example output):

Before: # encryption_key=2dFWQGnKhjOcz4h0CudPdVHLG2g+OoxP8FQOIKKTzsg= After: encryption_key=HbFK4I8CaStcvKKIx6aNpdTse0kTsfZNUjFpM+YUEjY=

5. Press Ctrl+O, ENTER to save the boto file, and then press Ctrl+X to exit nano.

Rewrite the key for file 1 and comment out the old decrypt key

When a file is encrypted, rewriting the file decrypts it using the decryption_key1 that you previously set, and encrypts the file with the new encryption_key.

You are rewriting the key for setup2.html, but not for setup3.html, so that you can see what happens if you don't rotate the keys properly.

1. Run the following command:

gsutil rewrite -k gs://$BUCKET_NAME_1/setup2.html

2. To open the boto file, run the following command:

nano .boto

3. Comment out the current decryption_key1 line by adding the # character back in.

Result (this is example output):

Before: decryption_key1=2dFWQGnKhjOcz4h0CudPdVHLG2g+OoxP8FQOIKKTzsg= After: # decryption_key1=2dFWQGnKhjOcz4h0CudPdVHLG2g+OoxP8FQOIKKTzsg=

4. Press Ctrl+O, ENTER to save the boto file, and then press Ctrl+X to exit nano.

Note: In practice, you would delete the old CSEK key from the decryption_key1 line.

Download setup 2 and setup3

1. To download setup2.html, run the following command:

gsutil cp gs://$BUCKET_NAME_1/setup2.html recover2.html

2. To download setup3.html, run the following command:

gsutil cp gs://$BUCKET_NAME_1/setup3.html recover3.html Note: What happened? setup3.html was not rewritten with the new key, so it can no longer be decrypted, and the copy will fail.

You have successfully rotated the CSEK keys.

Task 5. Enable lifecycle management

In this task, you enable lifecycle management for a Cloud Storage bucket to automate the deletion of objects after a specified period.

View the current lifecycle policy for the bucket

• Run the following command to view the current lifecycle policy:

gsutil lifecycle get gs://$BUCKET_NAME_1 Note: There is no lifecycle configuration. You create one in the next steps.

Create a JSON lifecycle policy file

1. To create a file named life.json, run the following command:

nano life.json

2. Paste the following value into the life.json file:

{ "rule": [ { "action": {"type": "Delete"}, "condition": {"age": 31} } ] } Note: These instructions tell Cloud Storage to delete the object after 31 days.

3. Press Ctrl+O, ENTER to save the file, and then press Ctrl+X to exit nano.

Set the policy and verify

1. To set the policy, run the following command:

gsutil lifecycle set life.json gs://$BUCKET_NAME_1

2. To verify the policy, run the following command:

gsutil lifecycle get gs://$BUCKET_NAME_1

Click Check my progress to verify the objective. Enable lifecycle management

Task 6. Enable versioning

In this task, you enable versioning for a Cloud Storage bucket to protect data from accidental deletion or modification.

View the versioning status for the bucket and enable versioning

1. Run the following command to view the current versioning status for the bucket:

gsutil versioning get gs://$BUCKET_NAME_1 Note: The Suspended policy means that it is not enabled.

2. To enable versioning, run the following command:

gsutil versioning set on gs://$BUCKET_NAME_1

3. To verify that versioning was enabled, run the following command:

gsutil versioning get gs://$BUCKET_NAME_1

Click Check my progress to verify the objective. Enable versioning

Create several versions of the sample file in the bucket

1. Check the size of the sample file:

ls -al setup.html

2. Open the setup.html file:

nano setup.html

3. Delete any 5 lines from setup.html to change the size of the file.
4. Press Ctrl+O, ENTER to save the file, and then press Ctrl+X to exit nano.
5. Copy the file to the bucket with the -v versioning option:

gcloud storage cp -v setup.html gs://$BUCKET_NAME_1

6. Open the setup.html file:

nano setup.html

7. Delete another 5 lines from setup.html to change the size of the file.
8. Press Ctrl+O, ENTER to save the file, and then press Ctrl+X to exit nano.
9. Copy the file to the bucket with the -v versioning option:

gcloud storage cp -v setup.html gs://$BUCKET_NAME_1

List all versions of the file

1. To list all versions of the file, run the following command:

gcloud storage ls -a gs://$BUCKET_NAME_1/setup.html

2. Highlight and copy the name of the oldest version of the file (the first listed), referred to as [VERSION_NAME] in the next step.

Note: Make sure to copy the full path of the file, starting with gs://

3. Store the version value in the environment variable [VERSION_NAME].

export VERSION_NAME=<Enter VERSION name here>

4. Verify it with echo:

echo $VERSION_NAME

Result (this is example output):

gs://BUCKET_NAME_1/setup.html#1584457872853517

Download the oldest, original version of the file and verify recovery

1. Download the original version of the file:

gcloud storage cp $VERSION_NAME recovered.txt

2. To verify recovery, run the following commands:

ls -al setup.html ls -al recovered.txt Note: You have recovered the original file from the backup version. Notice that the original is bigger than the current version because you deleted lines.

Task 7. Synchronize a directory to a bucket

In this task, you synchronize a local directory and its subdirectories with a Cloud Storage bucket using the gsutil rsync command.

Make a nested directory and sync with a bucket

Make a nested directory structure so that you can examine what happens when it is recursively copied to a bucket.

1. Run the following commands:

mkdir firstlevel mkdir ./firstlevel/secondlevel cp setup.html firstlevel cp setup.html firstlevel/secondlevel

2. To sync the firstlevel directory on the VM with your bucket, run the following command:

gsutil rsync -r ./firstlevel gs://$BUCKET_NAME_1/firstlevel

Examine the results

1. In the Google Cloud console, in the Navigation menu (), click Cloud Storage > Buckets.
2. Click [BUCKET_NAME_1]. Notice the subfolders in the bucket.
3. Click on /firstlevel and then on /secondlevel.
4. Compare what you see in the Cloud console with the results of the following command:

gcloud storage ls -r gs://$BUCKET_NAME_1/firstlevel

5. Exit Cloud Shell:

exit

Task 8. Review

In this lab you learned to create and work with buckets and objects, and you learned about the following features for Cloud Storage:

• CSEK: Customer-supplied encryption key
• Use your own encryption keys
• Rotate keys
• ACL: Access control list
• Set an ACL for private, and modify to public
• Lifecycle management
• Set policy to delete objects after 31 days
• Versioning
• Create a version and restore a previous version
• Directory synchronization
• Recursively synchronize a VM directory with a bucket

End your lab

When you have completed your lab, click End Lab. Google Cloud Skills Boost removes the resources you’ve used and cleans the account for you.

You will be given an opportunity to rate the lab experience. Select the applicable number of stars, type a comment, and then click Submit.

The number of stars indicates the following:

• 1 star = Very dissatisfied
• 2 stars = Dissatisfied
• 3 stars = Neutral
• 4 stars = Satisfied
• 5 stars = Very satisfied

You can close the dialog box if you don't want to provide feedback.

For feedback, suggestions, or corrections, please use the Support tab.

Copyright 2022 Google LLC All rights reserved. Google and the Google logo are trademarks of Google LLC. All other company and product names may be trademarks of the respective companies with which they are associated.