Greg Stachnick

We are pleased to announce the release of the new DataStax Astra Command Line Interface (CLI). For Apache Cassandra developers using <a href="https://astra.datastax.com">DataStax Astra DB</a>, the Astra CLI is a one stop shop for managing your Astra resources through scripts or in your local terminal. It covers a wide variety of capabilities including:
<ul>
<li style="font-weight: 400;" aria-level="1">Creation and management for Astra DB &amp; Astra Streaming artifacts</li>
<li style="font-weight: 400;" aria-level="1">Querying &amp; data loading</li>
<li style="font-weight: 400;" aria-level="1">Organization and user management</li>
<li style="font-weight: 400;" aria-level="1">Security and token configuration</li>
</ul>
<img src="https://cdn.sanity.io/images/bbnkhnhl/production/5a37bef31386cc3424d1befc760f82f6d5399f9d-2768x1718.png" alt="Astra Command Line Interface (CLI)" width="2768" height="1718" />Figure 1: Astra Command Line Interface (CLI)
Many developers prefer to work from the command line and having to switch contexts to a web UI can break up their development flow. The Astra CLI can run from any terminal or embedded integrated development environment (IDE) console to quickly connect to your Astra account and artifacts. This allows you to easily run simple development tasks like creating or resuming a database, checking the status of a streaming tenant, or running a query.&nbsp;
For DevOps engineers, the CLI provides the best way to streamline automation scripts which perform typical maintenance tasks or run test scenarios, which can then be incorporated into your CI/CD processes. With just a few commands, you can provision a new Astra database, load data with DSBulk, run tests, validate with queries using CQLSH, manage and configure Astra DB, and tear down the environment.&nbsp;
For management, configuration and operation of Astra DB, the CLI leverages the functionality provided by Astra DB&rsquo;s REST-based <a href="https://docs.datastax.com/en/astra-serverless/docs/manage/devops/devops-api.html">DevOps API</a>, much in the same way the web-based Astra DB Console does.&nbsp;&nbsp;
<h2>Installation</h2>
To get started with the Astra CLI on MAC laptops, run the following <a href="https://brew.sh/">Homebrew</a> installation command:
<code>brew install datastax/astra-cli/astra-cli</code>
This will install the Astra CLI through the Homebrew package manager. Additional installation options for Linux and Windows can be found <a href="https://awesome-astra.github.io/docs/pages/astra/astra-cli/#installation">here</a>.
Once installed, run the setup utility to authenticate to your Astra account using your application token:
<img src="https://cdn.sanity.io/images/bbnkhnhl/production/fd7d4b8cbe7b289581f94cdaf8720d9cab5f3ece-640x480.png" alt="" width="640" height="480" />
The Astra CLI is self-documented so that you can quickly lookup the commands and their options, either from the embedded help system or by using TAB completion. For example, to get help on database commands, just use:
<code>astra help db</code>
<img src="https://cdn.sanity.io/images/bbnkhnhl/production/fbefc11a1c1780b6ded149e9401bcf79e6b83c83-1018x452.png" />
The CLI will also download, install, and configure additional utilities as needed, such as:
<ul>
<li style="font-weight: 400;" aria-level="1">CQLSH to execute CQL queries</li>
<li style="font-weight: 400;" aria-level="1">DSBulk to load and unload data</li>
<li style="font-weight: 400;" aria-level="1">pulsar-shell to configure Astra Streaming tenants, producers, and consumers</li>
</ul>
Now we are off to the races and ready to work with Astra.&nbsp;
<h2>Create your first database</h2>
To create a new database simply provide the database and optional keyspace name.&nbsp;
<code>astra db create demo</code>
<img src="https://cdn.sanity.io/images/bbnkhnhl/production/44c5b77ebbb1a7190d6ff2f5defad4a0896afe87-1226x204.png" />
Once the database is created, you can list your databases using <code>list</code>.
<code>astra db list</code>
<img src="https://cdn.sanity.io/images/bbnkhnhl/production/15c9f92980036a47354891dbbe91357d2a648357-1452x346.png" />
Check out the video below to learn about data loading and querying:
<iframe title="YouTube video player" src="https://www.youtube.com/embed/ELl5v6bCYDU" width="560" height="315" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
<h2>Summary</h2>
The Astra CLI is a lightweight tool that fits neatly into any developer toolbox. Whether you are writing automated test suites, release management pipelines, or just want to administrate <a href="https://www.datastax.com/products/datastax-astra">Astra DB</a> and <a href="https://www.datastax.com/products/astra-streaming">Astra Streaming</a> from the keyboard versus your mouse, the Astra CLI is here to help.&nbsp;
While we have only scratched the surface, there is so much more that you can do with the CLI including managing multiple organizations, defining users and roles, and automating your Astra Streaming lifecycle. For more information, check out the resources below or try out one of the new Getting Started guides in Astra itself.
This is only the first release, but you can expect more features and functionality for the Astra CLI in the near future. We&rsquo;ll add support for more package managers which simplify installation like SDKMan and Yum, security configuration for Private Link with AWS and Azure, and configuration options for Change Data Capture (CDC).
Happy scripting!
<h2>Resources</h2>
<ul>
<li style="font-weight: 400;" aria-level="1"><a href="https://github.com/datastax/astra-cli">Github</a></li>
<li style="font-weight: 400;" aria-level="1"><a href="https://awesome-astra.github.io/docs/pages/astra/astra-cli/">Awesome Astra</a> Tutorial Walkthrough</li>
<li style="font-weight: 400;" aria-level="1">Try the Astra CLI in our <a style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif;" href="https://www.youtube.com/watch?v=jCq0Eg0RnLU">Java and Python Workshop</a></li>
</ul>

Build and scale cloud native apps

Discover the benefits of DBaaS and why your apps deserve an upgrade.

Learn about NoSQL Databases

Learn about NoSQL databases with Apache Cassandra and Astra DB.

2022 Recap: A Year for Customers, Community, and Real-Time Data

Highlights from 2022 and a glimpse into the year ahead.

ViewingCompany

Accelerate your Cassandra development and automation with the Astra CLI

Sign up for our Developer Newsletter