Get Started

Get Started

These guides demonstrate how to get started quickly with Hazelcast IMDG and Hazelcast Jet.

Hazelcast IMDG

Learn how to store and retrieve data from a distributed key-value store using Hazelcast IMDG. In this guide you’ll learn how to:

  • Create a cluster of 3 members.
  • Start Hazelcast Management Center
  • Add data to the cluster using a sample client in the language of your choice
  • Add and remove some cluster members to demonstrate data balancing capabilities of Hazelcast

Hazelcast Jet

Learn how to build a distributed data processing pipeline in Java using Hazelcast Jet. In this guide you’ll learn how to:

  • Install Hazelcast Jet and form a cluster on your computer
  • Build a simple pipeline that receives a stream of data, does some calculations and outputs some results
  • Submit the pipeline as a job to the cluster and observe the results
  • Scale the cluster up and down while the job is still running

Announcing Hazelcast Cloud CLI

December 01, 2020
Announcing Hazelcast Cloud CLI

We are happy to announce Hazelcast Cloud CLI (hzcloud) to provide full automation for your Hazelcast clusters and related operations. We all believe in the power of automation and if you already have Hazelcast within your pipeline, you can insert the missing piece by using hzcloud. To try examples here, you can create a Hazelcast Cloud account and get API Credentials

Installation

hzcloud supports various distributions including Mac, Linux, Windows, as well as different architectures including amd64 and even arm! You can select one of your favorite installation methods which are described here

Getting API Credentials

If you don’t have an account, you can get a free one to see your Developer page. On the developer page, click Generate new API key to see your credentials. Copy API Key and API Secret to use it inside hzcloud tool. Keep in mind that, you will not see your credentials for the second time, be sure you keep them in a safe place before leaving the developer page. If you somehow lose it, you can delete it and generate a new one.

Hazelcast Cloud Developer Page
Hazelcast Cloud Generate API Credentials

Authentication

You can authenticate into Hazelcast Cloud by using hzcloud in 2 ways;

  1. hzcloud login -> provide credentials withing console prompt -> execute hzcloud commands
  2. Provide Hazelcast Cloud specific environment variables -> execute hzcloud commands

You can see advanced details about the above methods in the documentation, but in this blog I will use the first way. However, if you are doing automation, you may want to use the second method.

$ hzcloud login
- Api Key: SAMPLE_API_KEY
- Api Secret: SAMPLE_API_SECRET

You can simply pass the API Key and API Secret within the terminal prompt.

hzcloud authentication

As you can see in the terminal, if there is a new version, we notify you about this so that you can upgrade to the latest version to use new features.

Hands-on Examples

Create Cluster

While you can see the possible parameters of creating a cluster from the help command, you can use the following command to create a starter cluster easily.

hzcloud starter-cluster create \
    --cloud-provider=aws \
    --cluster-type=FREE \
    --name=mycluster \
    --region=us-west-2 \
    --total-memory=0.2 \
    --hazelcast-version=4.0

Show Cluster Details

You can see cluster details by using get subcommand with cluster-id param which is required.

hzcloud starter-cluster get --cluster-id=54069

List Clusters

Listing to iterate, is a good mechanism to satisfy your automation process. You can list clusters by using list subcommand.

hzcloud starter-cluster get –cluster-id=54069

For better visibility, we show details within the tabular view, but you can always change it by using –output param. You can use this param for getting details and various other commands.

We tried to show you some starting point about hzlcloud, but you can see more advanced examples and internals within documentation here.

About the Author

About the Author

Huseyin Babal

Huseyin Babal

Development Team Lead, Hazelcast Cloud

Hüseyin BABAL is currently the development team lead of Hazelcast Cloud. He mainly focused on building SaaS on multi-cloud platforms based on Kubernetes and talking about those topics in public events. Prior to joining Hazelcast, he worked as Software Architect in eBay and Sony for their devops and microservices transition process.

Latest Blogs

Postmortem Chronicles – Prometheus is Good, But Be Careful!

View all blogs by the author
Join Us On Slack