Why Environment variables and secrets in GCP? - Purpose & Use Cases

The Big Idea

What if your app's secrets could stay safe and update themselves without you lifting a finger?

The Scenario

Imagine you have to manually type sensitive information like passwords or API keys into your app every time you deploy it. You write them in your code or config files, then share those files with your team.

This feels risky and messy, especially when you want to keep secrets safe and change them often.

The Problem

Manually handling secrets is slow and risky. You might accidentally share passwords in public code or forget to update them everywhere.

It's easy to make mistakes that expose your data or break your app when secrets change.

The Solution

Using environment variables and secret managers lets you keep sensitive info separate from your code.

You store secrets securely and your app reads them automatically when it runs. This keeps secrets safe and makes updates easy.

Before vs After

✗ Before

const apiKey = "12345-secret"; // hardcoded in code

✓ After

const apiKey = process.env.API_KEY; // loaded from environment

What It Enables

You can safely manage and update secrets without touching your code, making your apps more secure and easier to maintain.

Real Life Example

A developer uses Google Cloud Secret Manager to store database passwords. The app fetches these secrets at runtime, so passwords never appear in code or logs.

Key Takeaways

Manual secret handling risks exposure and errors.

Environment variables separate config from code.

Secret managers keep sensitive data safe and easy to update.

Practice

1. What is the main purpose of environment variables in a Google Cloud application?

easy

A. To permanently save user data in the cloud

B. To create virtual machines automatically

C. To encrypt all data sent over the network

D. To store configuration values that the app can use at runtime

Solution

1. Step 1: Understand environment variables

   Environment variables hold configuration values like API URLs or feature flags that apps read when running.

2. Step 2: Eliminate distractor options

   Permanent data storage, network encryption, and VM creation are unrelated to environment variables.

3. Final Answer:

   To store configuration values that the app can use at runtime -> Option D

4. Quick Check:

   Environment variables = config values [OK]

Hint: Environment variables hold settings your app reads [OK]

Common Mistakes:

• Confusing environment variables with data storage
• Thinking environment variables encrypt data
• Mixing environment variables with cloud resource creation

2. Which of the following is the correct way to set an environment variable named API_KEY with value 12345 in a Google Cloud Run service YAML?

easy

A. env:
- name: API_KEY
value: '12345'

B. environment_variables:
API_KEY: 12345

C. variables:
API_KEY = '12345'

D. set_env:
API_KEY: '12345'

Solution

1. Step 1: Recall Cloud Run YAML env syntax

   Cloud Run uses the env list with name and value keys to set environment variables.

2. Step 2: Check options for correct YAML format

   env: - name: API_KEY value: '12345' matches the correct syntax. Other options use incorrect keys or formats not supported by Cloud Run.

3. Final Answer:

   env: - name: API_KEY value: '12345' -> Option A

4. Quick Check:

   Cloud Run env uses name and value keys [OK]

Hint: Look for 'env' with name and value keys in YAML [OK]

Common Mistakes:

• Using incorrect keys like environment_variables or variables
• Assigning values with '=' instead of colon
• Not using a list for env variables

3. Given this Python code snippet running in a Google Cloud Function:

import os
api_key = os.getenv('API_KEY')
print(f"Key: {api_key}")

If the environment variable API_KEY is not set, what will be printed?

medium

A. Key: API_KEY

B. Key:

C. Key: None

D. Error: Environment variable not found

Solution

1. Step 1: Understand os.getenv behavior

   When the environment variable is missing, os.getenv returns None by default.

2. Step 2: Analyze the print output

   The f-string converts None to the string 'None', so the output is 'Key: None'.

3. Final Answer:

   Key: None -> Option C

4. Quick Check:

   Missing env var returns None [OK]

Hint: os.getenv returns None if variable missing [OK]

Common Mistakes:

• Assuming empty string is returned
• Expecting an error to be raised
• Thinking variable name is printed

4. You deployed a Cloud Run service that uses a secret from Secret Manager, but the service fails to access the secret. Which is the most likely cause?

medium

A. The Cloud Run service account lacks permission to access the secret

B. The secret value is empty

C. The environment variable name is misspelled in the code

D. The secret was created in a different Google Cloud project

Solution

1. Step 1: Check permissions for Secret Manager access

   Cloud Run uses a service account that must have Secret Manager access roles to read secrets.

2. Step 2: Evaluate other options

   While empty secret values, misspelled variable names, or secrets in different projects can cause issues, the most common cause is missing permissions blocking secret access.

3. Final Answer:

   The Cloud Run service account lacks permission to access the secret -> Option A

4. Quick Check:

   Missing permissions block secret access [OK]

Hint: Check service account permissions first [OK]

Common Mistakes:

• Ignoring IAM roles for service accounts
• Assuming secret value is always the problem
• Not verifying project alignment for secrets

5. You want to securely provide a database password to a Google Cloud Run service without hardcoding it. Which approach follows best practices?

hard

A. Hardcode the password in the Cloud Run service YAML file

B. Store the password in Secret Manager and mount it as an environment variable in Cloud Run

C. Save the password in a public Google Cloud Storage bucket and read it at runtime

D. Send the password as a query parameter in API requests

Solution

1. Step 1: Identify secure secret storage

   Google Secret Manager is designed to store sensitive info like passwords securely.

2. Step 2: Use environment variables for app access

   Mounting secrets as environment variables in Cloud Run keeps secrets out of code and config files.

3. Step 3: Evaluate other options

   Hardcoding, public storage, or sending passwords in URLs expose secrets and are insecure.

4. Final Answer:

   Store the password in Secret Manager and mount it as an environment variable in Cloud Run -> Option B

5. Quick Check:

   Secret Manager + env vars = secure best practice [OK]

Hint: Use Secret Manager and env vars, never hardcode secrets [OK]

Common Mistakes:

• Hardcoding secrets in config files
• Using public storage for sensitive data
• Exposing secrets in URLs or logs