---
title: "Redis Enterprise Cloud AWS Example"
description: "A minimal TypeScript Pulumi program"
url: "https://www.pulumi.com/dev/examples/redis-cloud-aws-ts/"
image: "https://www.pulumi.com/assets/og/dev/examples/redis-cloud-aws-ts.png"
---

# Redis Enterprise Cloud AWS Example

A minimal TypeScript Pulumi program

- Source on GitHub: https://github.com/pulumi/examples/tree/master/redis-cloud-aws-ts

## Get started with this example

This example lives in the [pulumi/examples](https://github.com/pulumi/examples/tree/master/redis-cloud-aws-ts) repo. Pull down just this directory to follow along:

```bash
git clone --filter=blob:none --sparse https://github.com/pulumi/examples pulumi-examples
git -C pulumi-examples sparse-checkout set redis-cloud-aws-ts
cd pulumi-examples/redis-cloud-aws-ts
```

This example contains code that creates a [Redis Enterprise Cloud](https://app.redislabs.com/) cluster and connects it to an AWS VPC via VPC Peering. This stack also includes an EC2 instance with SSM Session Manager that can run Redis commands to verify connectivity to the Redis cluster.

![Architecture diagram of an AWS VPC across 3 availability zones, connected to Redis Enterprise Cloud via VPC peering](./images/architecture.png)

## Prerequisites

1. [Install Pulumi](https://www.pulumi.com/docs/get-started/install/)
1. [Configure the Redis Cloud provider](https://www.pulumi.com/registry/packages/rediscloud/installation-configuration/)
1. Ensure you have a payment method specified in the Redis Enterprise Cloud console.
1. [Configure the AWS Classic provider](https://www.pulumi.com/registry/packages/aws/installation-configuration/)
1. [Install NodeJS](https://nodejs.org/en/download)

## Deploy the app

1. Set configuration values for your Redis Cloud payment information:

    ```bash
    pulumi config set cardType <YOUR-CARD-TYPE> # e.g. Visa (capitalization matters)
    pulumi config set lastFourNumbers 1234
    ```

1. If you are using an availability zone other than `us-east-1`, you will need to set `preferredAz`, e.g. if you're using `us-west-2`:

    ```bash
    pulumi config set aws:region us-west-2 # Not necessary if your default AWS region is e.g. us-west-2
    pulumi config set preferredAz usw2-az1 # This step is necessary is your default or selected region is not us-east-1
    ```

1. Deploy the architecture:

    ```bash
    pulumi up
    ```

## Test the architecture

1. In the AWS Console, find the EC2 instance named `pulumi-redis-cloud-tester`, and connect to it via SSM Systems Manager:

    ![AWS EC2 console, listing available instances](./images/ec2-console.png)
    ![AWS EC2 connect dialog](./images/ec2-connect.png)

1. In the [Redis Cloud console](https://app.redislabs.com/), locate your database, and select "Connect":

1. In the connection dialog, copy the connection info for the Redis CLI:

    ![Redis Cloud console showing the connection dialog with the CLI option selected](./images/redis-console.png)

1. Paste the command into the Systems Manager shell prompt, which will connect you to the Redis instance. From there you can run Redis commands like `INCR` that will write to the Redis cluster:

    ![SSM Systems Manager shell with commands like redis connect and INCR](./images/shell-commands.png)

## Clean up

1. Run `pulumi destroy` to tear down all resources.
1. To delete the stack itself, run `pulumi stack rm`. Note that this command deletes all deployment history from the Pulumi Cloud console.