/azion-cli

Azion CLI is a tool that enables you to manage any Azion service via command line.

Primary LanguageGoMIT LicenseMIT

Azion CLI

MIT License CLI Reference Go Report Card

Azion CLI is a user-friendly way to work with the Azion Edge Platform, allowing you to create and manage applications through simple commands. It makes possible the initialization, build, and deployment of applications, from simple static pages to different frameworks, such as:

  • Next.js
  • Vue
  • Angular
  • Astro
  • Hexo
  • Vite

Through it, you can manage all Azion products, create automation using CI/CD scripts or pipelines, provision multiple services that make up your application with a few commands, and also manage your Azion configurations as code.

The developer-friendly way to interact with Azion!

Quick links

Downloading

Attention: if you've downloaded azioncli in an older version than 1.0.0, it's highly recommended to uninstall it before downloading azion CLI.

There are two ways to download and use the azion CLI:

  • Cloning this repository and building the project manually.
  • Package managers, since azion is also available as homebrew, rpm, deb and apk packages.

To use rpm, deb and apk packages, please visit our releases page, and download the desired package.

To download azion CLI through Homebrew, run:

brew install aziontech/tap/azion

Building Locally

# Build project, by default it will connect to Production APIs
$ make build

# Cross-Build for multiple platforms and architectures
$ make cross-build

How to Use

Authentication

In order to perform network operations it is mandatory to provide an authentication token.

You can provide the token in two ways:

  • Using azion -t [tokenvalue] command, which saves the token in a configuration file for further use:
$ azion -t <authentication token>
  • Using environment variable, which the token is cleared when the terminal is closed:
$ export AZIONCLI_TOKEN=<authentication token>

Commands

Check all reference documentation for the available commands.

Autocomplete

It's possible to enable the autocompletion to be used with the azion CLI. To learn more about its settings and installation based on your OS, check the autocompletion page.

License

This project is licensed under the terms of the MIT license.