thamanyah/infrastructure

AWS S3 Bucket (Go) Pulumi Template

This Pulumi template bootstraps a minimal Go project that provisions an AWS S3 bucket. It uses the Pulumi AWS provider to create the bucket and exports its name as an output.

When to Use This Template

Use this template when you want to:

• Get started quickly with Pulumi and Go for AWS workloads
• Provision a simple S3 bucket with minimal configuration
• Learn how Pulumi programs are structured in Go

Providers & Resources

• AWS Provider (github.com/pulumi/pulumi-aws/sdk/v6)
• Resource Created: aws:s3/bucket:Bucket via s3.NewBucketV2

Outputs

• bucketName: The unique name/ID of the created S3 bucket

Prerequisites

• Go 1.20 or later
• An AWS account with credentials configured in your environment (for example, via the AWS CLI)
• Pulumi CLI installed and authenticated

Getting Started

1. Create a new stack/project from this template:

   pulumi new aws-go
   

2. Follow the interactive prompts to set:

   • Project name (used in Pulumi.yaml)
   • Project description
   • AWS region (defaults to us-east-1)

3. Preview your changes:

   pulumi preview
   

4. Deploy your stack:

   pulumi up
   

5. Verify the output:

   pulumi stack output bucketName
   

Project Layout

.
├── Pulumi.yaml     Pulumi project settings and metadata
├── go.mod          Go module definition (updated on `pulumi new`)
└── main.go         Pulumi program that creates the S3 bucket

Configuration

The following configuration keys are available:

• aws:region (string): The AWS region where resources will be created. Default: us-east-1.

You can view or update configuration values with:

pulumi config get aws:region
pulumi config set aws:region us-west-2

Next Steps

• Customize the bucket by passing options to s3.NewBucketV2, such as versioning, encryption, tags, etc.
• Add additional AWS resources (e.g., IAM roles, DynamoDB tables) by importing and using other Pulumi AWS SDK packages.
• Explore Pulumi’s Go SDK patterns, such as component resources and functions.
• Integrate infrastructure as code into your CI/CD pipelines.

Getting Help

If you run into issues or have questions:

• Check the Pulumi documentation: https://www.pulumi.com/docs/
• Browse AWS provider reference: https://www.pulumi.com/registry/packages/aws/api-docs/
• Ask in the Pulumi Community Slack: https://slack.pulumi.com/
• Open an issue on the template’s repository (if available)

Enjoy building cloud infrastructure with Go and Pulumi!