Skip to content

About

Pulumi provider for Event Store Cloud

Resources

Code of conduct

Contributing

Stars

3 stars

Watchers

17 watching

Forks

Repository files navigation

Pulumi provider for Kurrent Cloud (formerly Event Store Cloud)

The kurrentcloud provider lets you manage Kurrent Cloud resources with Pulumi in TypeScript/JavaScript, Python, Go, and .NET. It is generated from the Kurrent Cloud Terraform provider via the Pulumi Terraform Bridge, so its resources track the Terraform provider.

Renamed from eventstorecloud. Existing stacks keep working: every resource declares a Pulumi alias to its historical eventstorecloud:index/<resource>:<Type> type, so running pulumi up after upgrading refreshes onto the new kurrentcloud:index/<resource>:<Type> tokens without replacing any cloud resources. See MIGRATION.md.

This repository was renamed from pulumi-eventstorecloud. The eventstorecloud provider (v0.2.x) still installs from here, because GitHub redirects the old EventStore/pulumi-eventstorecloud and kurrent-io/pulumi-eventstorecloud URLs to this repository. Never create a repository named pulumi-eventstorecloud under kurrent-io or EventStore: that removes the redirect and breaks every existing eventstorecloud install. Never tag v0.2.x on main: every tag runs the release workflow, which publishes kurrentcloud. There is no release process for v0.2.x today. A fix would need a release/v0.2 branch cut from v0.2.20, with release.make_latest: false in its .goreleaser.yaml, and its release.yml moved to trusted publishing (this repository keeps no publishing secrets), with trusted publishers added for Pulumi.EventStoreCloud on nuget.org and @eventstore/pulumi-eventstorecloud on npm.

Installing

Get the plugin

For projects that use the .NET and Go Pulumi SDKs you must install the provider plugin before updating the stack:

pulumi plugin install resource kurrentcloud --server github://api.github.com/kurrent-io

Node.js (TypeScript/JavaScript)

npm install @kurrent/pulumi-kurrentcloud
# or
yarn add @kurrent/pulumi-kurrentcloud

Python

pip install pulumi_kurrentcloud

Go

go get github.com/kurrent-io/pulumi-kurrentcloud/sdk/go/kurrentcloud

.NET

dotnet add package Kurrent.Pulumi.KurrentCloud

Configuration

The following configuration options are required for the kurrentcloud provider:

  • kurrentcloud:organizationId - the organization ID for an existing organization in Kurrent Cloud
  • kurrentcloud:token - a valid refresh token for a Kurrent Cloud account with admin access to the organization

Alternatively, these values can be set via the ESC_ORG_ID and ESC_TOKEN environment variables.

Resources

This provider mirrors the Kurrent Cloud Terraform provider:

  • Project, Network, Peering, Acl
  • ManagedCluster and ManagedClusterReplicaset (read-only replica sets attached to a managed cluster)
  • ScheduledBackup
  • Integration, AWSCloudWatchLogsIntegration, AWSCloudWatchMetricsIntegration
  • data sources: getProject, getNetwork

Example (TypeScript): a managed cluster with a read-only replica set

import * as pulumi from "@pulumi/pulumi";
import * as kurrent from "@kurrent/pulumi-kurrentcloud";

const project = new kurrent.Project("project", { name: "my-project" });

const network = new kurrent.Network("network", {
    name: "my-network",
    projectId: project.id,
    resourceProvider: "aws",
    region: "us-west-2",
    cidrBlock: "172.21.0.0/16",
});

const cluster = new kurrent.ManagedCluster("cluster", {
    name: "my-cluster",
    projectId: project.id,
    networkId: network.id,
    topology: "single-node",
    instanceType: "F1",
    diskSize: 24,
    diskType: "gp3",
    diskIops: 3000,
    diskThroughput: 125,
    serverVersion: "24.10",
    projectionLevel: "off",
});

// New in this provider: a read-only replica set attached to the managed cluster.
const replica = new kurrent.ManagedClusterReplicaset("replica", {
    projectId: project.id,
    clusterId: cluster.id,
    replicaCount: 1,
});

export const clusterDnsName = cluster.dnsName;

Testing

End-to-end tests exercise every resource and data source against a real Kurrent Cloud organization (via the Pulumi Automation API), alongside an offline guard that verifies the eventstorecloud→kurrentcloud migration aliases. See TESTING.md for the harness, the required environment variables (and where their values come from), and how to run it locally and in CI.

Reference

For detailed reference documentation, please visit the Pulumi registry.

About

Pulumi provider for Event Store Cloud

Resources

Code of conduct

Contributing

Stars

3 stars

Watchers

17 watching

Forks

Releases

Packages

Used by

Contributors

Languages