Cloud Environments set up your AWS, GCP, or Azure account with everything it needs to create and run Pulsar Clusters. You can create a Cloud Environment either through snctl, or StreamNative's terraform provider. Once you have created a Cloud Environment, you can create an Instance and Pulsar Cluster through the StreamNative Console

Create a Cloud Environment on UI

1. Sign in to StreamNative Cloud at https://console.streamnative.cloud.

2. Select the Organization.

3. Expand the user profile drop down and click on the Cloud Environments page

   

4. On the Cloud Environments page, click the New button and select Create environment.

5. Select the CloudConnection, then click Environment setup.

   

6. Specify the region and other configurations, then click Create.

   

Tutorial

You can also watch the video of creating a cloud environment using Cloud Console UI:

Create a Cloud Environment with snctl

To create a Cloud Environment using snctl, use snctl create cloudenvironment. Usage:

  snctl create cloudenvironment --cloud-connection-name CLOUD_CONNECTION_NAME --region REGION

Examples

snctl create cloudenvionment --cloud-connection-name share-aws --region us-east-1 -n orgname

Tutorial

You can also watch the video of creating a cloud environment using snctl:

Create a Cloud Environment with terraform

To create a Cloud Environment with terraform:

1. Prepare main.tf
2. Run terraform init
3. Run terraform apply

Cloud Environment Schema

Examples

module "sn_managed_cloud" {
  source = "github.com/streamnative/terraform-managed-cloud//modules/aws?ref=v3.13.1"

  external_id = "<YOUR_SNCLOUD_ORG_ID>"
}

resource "streamnative_cloud_connection" "shared_aws" {
    depends_on = [ module.sn_managed_cloud ]
    organization = "orgname"
    name = "shared-aws"

    type = "aws"
    aws {
        account_id = "xxx"
    }
}

resource "streamnative_cloud_environment" "aws_usw1_production" {
    depends_on = [ streamnative_cloud_connection.shared_aws ]
    organization = "orgname"
    region = "us-west-1"
    cloud_connection_name = "shared-aws"

    network {
      cidr = "10.60.0.0/16"
    }
}

Tutorial

You can also watch the video of creating a cloud environment using Terraform:

Monitoring the Provisioning Process

Creating a Cloud Environment through Terraform does not immediately create the Cloud Environment, but rather kicks off a process that creates it. In order to monitor that process, you can use snctl.

snctl describe -n orgname cloudenvironment name-of-your-environment

Once snctl describe returns a status of True and a type of Ready your Cloud Environment has been provisioned, and you can create a Pulsar Cluster within it. This should take approximately 40 minutes.

If this command returns an error state, please reach out to the StreamNative support team.

Recommended default CIDR Values

If you are using a StreamNative-managed VPC as described in the documentation above, we recommend the following default CIDR values.

• AWS
  • Default VPC CIDR: 10.60.0.0/16 (must between /16 and /28), but we suggest using /16 to /18, otherwise there will not be enough IP addresses.
  • The subnet CIDR will be calculated by VPC CIDR.
• GCP
  • Default VPC CIDR: 10.0.0.0/16
• Azure
  • Default VPC CIDR: 10.70.0.0/16
  • Default Subnet CIDR: 10.70.0.0/24

Next steps

With one or multiple Cloud Environments in place, you can then start to create StreamNative instances and clusters using those cloud environments.