astra-setup

Prerequisites

• node.js version 15+
• npm version 7+
• These can be updated using instructions here.

Getting the module

The easiest way to grab this for use in your project is to do the following:

• Make sure you have the most recent npm: npm install -g npm@latest
• Install astra-js npm install -g astra-setup.
• Run the command: npm exec astra-setup

Alternately, you can clone this repository and run npm install to pull in requirements.

Running the module

To setup your ASTRA instance, you want to run npm exec astra-setup If you get "npm exec not found" try npx astra-setup

This will do the following:

• Have you go to your Astra Database to register or login. There is no credit card required to sign up. The 'Pay as you go' option gives you a huge amount of transactions for free:
  • 30 million reads
  • 5 million writes
  • 40 gigabytes of storage
• Give steps to grab a Database Administrator Token and paste it into the input field
• Ask you what database you want to use (default, existing, create)
• Create or access the database
• Create/update an .env file in the project root
• Create/update an .astrarc file in your home directory
  • This can be used by httpie-astra pip3 install httpie-astra
  • It can also be used by the @astra/collections and @astra/rest node modules

Specify the database and keyspace

You can run the script and tell it which database/keyspace to use by using: npm exec astra-setup databasename keyspacename