Creating a SmartBucket

Overview

SmartBuckets are managed through Raindrop applications, which provides several benefits:

Full versioning capabilities
Consistent deployment patterns
Resource management
Access control integration

Prerequisites

Before creating a SmartBucket, ensure you have:

Raindrop CLI installed and authenticated.
Appropriate permissions in your Raindrop account
Basic understanding of Raindrop manifest syntax

Step-by-Step Creation Process

1. Initialize a New Raindrop Application

First, create a new Raindrop application that will contain your SmartBucket:

raindrop build init demo

This command:

Creates a new application directory
Initializes the basic manifest structure
Sets up version control
Configures deployment settings

2. Configure the SmartBucket Resource

Add the SmartBucket configuration to your application manifest:

application "demo" {
    smartbucket "bucket-1" {}
}

This configuration:

Declares a new SmartBucket resource
Associates it with your application
Sets the bucket identifier
Enables versioning capabilities

You can define multiple SmartBuckets within a single application by adding more SmartBucket declarations with unique names:

application "demo" {
    smartbucket "bucket-1" {}
    smartbucket "bucket-2" {}
}

3. Deploy Your SmartBucket

Deploy your configuration using the Raindrop CLI:

raindrop build generate
raindrop build deploy

During deployment, Raindrop validates your manifest, creates the required infrastructure and AI pipelines, configures access controls, and initializes storage backends for your SmartBucket.

4. Accessing Your SmartBucket

After deployment, you’ll need the resource ID to interact with your SmartBucket. You can find this on the resource overview of the associated application on raindrop.run.

The resource ID is needed for performing CLI operations, integrating with the SDK, making API calls, and managing access controls.

Technical Considerations

SmartBucket names must be unique within an application
Resource IDs are automatically generated during deployment
Versioning is enabled by default
Changes to SmartBucket configuration require redeployment

Next Steps

After creating your SmartBucket, you can: