Skip to content

Latest commit

 

History

History
81 lines (56 loc) · 3.15 KB

README.md

File metadata and controls

81 lines (56 loc) · 3.15 KB

image

Beginner Cloud

You can use Confluent Cloud CLI to interact with your Confluent Cloud cluster.

start.sh is a fully scripted demo that shows users how to interact with Confluent Cloud, stepping through the following workflow using the CLI, and it takes about 8 minutes to complete:

  • Log in to Confluent Cloud
  • Create a new environment and specify it as the default
  • Create a new Kafka cluster and specify it as the default
  • Create a user key/secret pair and specify it as the default
  • Produce and consume with Confluent Cloud CLI
  • Create a service account key/secret pair
  • Run a Java producer: before and after ACLs
  • Run a Java producer: showcase a Prefix ACL
  • Run Connect and kafka-connect-datagen connector with permissions
  • Run a Java consumer: showcase a Wildcard ACL
  • Delete the API key, service account, Kafka topics, Kafka cluster, environment, and the log files

Run the demo

DISCLAIMER

This demo is for reference purposes only and should be used to see a sample workflow using Confluent Cloud CLI

If you choose to run it against your Confluent Cloud cluster, be aware that it:

  • creates and deletes topics, service accounts, API keys, and ACLs
  • is for demo purposes only
  • should be used only on a non-production cluster

Pre-requisites

  • Access to a Confluent Cloud cluster
  • Local install of the new Confluent Cloud CLI v0.192.0 or later
  • Docker and Docker Compose (for the local Connect worker)
  • timeout installed on your host
  • mvn installed on your host
  • jq installed on your host
  • expect installed on your host

Usage

Option 1: Provide all arguments on command line

./start.sh <url to cloud> <cloud email> <cloud password>

Option 2: Provide all arguments on command line, except password for which you will be prompted

./start.sh <url to cloud> <cloud email>

Clean up after the demo

If a demo run ended prematurely, it may not have totally cleaned up after itself and a new run may error out with the following message:

# Create and specify active environment
ccloud environment create demo-script-env
Error: 1 error occurred:
	* error creating account: Account name is already in use


Failed to create environment demo-script-env. Please troubleshoot and run again

You may need to manually delete API keys and ACLs created in a previous demo run. But you could consider running the following script to delete the demo's topics, Kafka cluster, and environment. Use this script with extreme caution and only in non-production environments.

./cleanup.sh <url to cloud> <cloud email> <cloud password>

Other Resources

See other Confluent Cloud demos.