{"id":42475586,"url":"https://github.com/airnity/airnity-cli-releases","last_synced_at":"2026-05-27T00:02:09.434Z","repository":{"id":318381587,"uuid":"1071053977","full_name":"airnity/airnity-cli-releases","owner":"airnity","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-23T13:42:31.000Z","size":13,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-23T15:24:20.346Z","etag":null,"topics":["env-dev","env-it","env-prod","owner-team-platform"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/airnity.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-06T19:57:17.000Z","updated_at":"2026-05-23T13:42:34.000Z","dependencies_parsed_at":"2026-03-06T13:01:11.235Z","dependency_job_id":null,"html_url":"https://github.com/airnity/airnity-cli-releases","commit_stats":null,"previous_names":["airnity/airnity-cli-releases"],"tags_count":34,"template":false,"template_full_name":null,"purl":"pkg:github/airnity/airnity-cli-releases","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/airnity%2Fairnity-cli-releases","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/airnity%2Fairnity-cli-releases/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/airnity%2Fairnity-cli-releases/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/airnity%2Fairnity-cli-releases/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/airnity","download_url":"https://codeload.github.com/airnity/airnity-cli-releases/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/airnity%2Fairnity-cli-releases/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33543973,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"ssl_error","status_checked_at":"2026-05-26T15:22:15.568Z","response_time":63,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["env-dev","env-it","env-prod","owner-team-platform"],"created_at":"2026-01-28T10:17:06.384Z","updated_at":"2026-05-27T00:02:09.413Z","avatar_url":"https://github.com/airnity.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Airnity CLI\n\nThis project aims to simplify the Airnity developer life.\n\nIt is a Command Line Interface to automate several boring and repetitive tasks.\n\n## Install\n\nTo install `airnity` cli, go to the [Release Page](https://github.com/airnity/airnity-cli-releases/releases), and download the binary corresponding to your architecture.\n\nYou can then rename the binary to its original name: `airnity` (or `airnity.exe` on windows), and move it to a place in your `$PATH` (eg: `~/.local/bin`)\n\n### For mac users\n\n```shell\n# Open Terminal app\n# You are now in your $HOME folder\n# Check if you have a \".local/bin\" folder\nls .local/bin # (Press Enter)\n# if you get a \"not found\" message create the folder hierarchy\nmkdir -p .local/bin # (Press Enter)\n# Add this new folder to the list of folders known for containing binaries\necho \"export PATH=$HOME/.local/bin:$PATH\" \u003e\u003e .zshrc # (Press Enter)\n# Go in your download folder\ncd ~/Downloads # (Press Enter)\n# Move and rename binary\nmv airnity-darwin-arm64 ~/.local/bin/airnity # (Press Enter)\n# Change permissions to make it executable\nchmod +x ~/.local/bin/airnity # (Press Enter)\n# then use it with `airnity --help`\n```\n\n### For linux users\n\n```shell\n# Go in your download folder\ncd ~/Downloads\n# Move and rename binary\nmv airnity-linux-amd64 ~/.local/bin/airnity # (Press Enter)\n# Change permissions\nchmod +x ~/.local/bin/airnity # (Press Enter)\n# then use it with `airnity --help`\n```\n\n### For windows users\n\n```shell\n# Open Windows PowerShell (Run as Administrator)\n# Go in your download folder \ncd $env:USERPROFILE\\Downloads # (Press Enter)\n# Move and rename binary\nCopy-Item \"airnity-windows-amd64.exe\" \"$env:WINDIR\\System32\\airnity.exe\" # (Press Enter)\n# then use it with `airnity.exe --help`\n```\n\nYou are good to go!\n\n## External Requirements (Only for GCP and clusters access)\n\nThis binary requires the following tools and components to be installed:\n\n1. **Google Cloud SDK (`gcloud`)**\n\n   The `gcloud` command-line tool is essential for interacting with Google Cloud services.\n\n   - [Installation Guide](https://cloud.google.com/sdk/docs/install)\n\n2. **`gke-gcloud-auth-plugin` Component**\n\n   Required for authenticating with Google Kubernetes Engine (GKE).\n\n   ```shell\n   gcloud components install gke-gcloud-auth-plugin\n   ```\n\n## Config Management\n\nThe `airnity` CLI uses the config file `${HOME}/.airnity.yaml`, which is created with default values if it doesn't exist.\n\n### Displaying the Current Configuration\n\nYou can display the current configuration using the `config get` command:\n\n```shell\nairnity config get\n```\n\nYou can customize the newly created `${HOME}/.airnity.yaml` as needed.\n\n## Commands\n\nThe Airnity CLI provides various commands organized by functionality:\n\n### Version Information\n\n```shell\nairnity version\n```\n\nDisplay version information including git commit and build details.\n\n### Configuration Management\n\n```shell\n# Display current configuration\nairnity config get\n\n# Set individual configuration values\nairnity config set username \"john.doe\"\nairnity config set wazuh.enrollmentPassword \"mypassword\"\nairnity config set k8s.kubeconfigPath \"~/.kube/custom-config\"\n```\n\nThe `config set` command allows you to update individual configuration values. Valid keys include:\n- `username`: Your Airnity username (e.g john.doe if your email is john.doe@airnity.com)\n- `k8s.kubeconfigPath`: Path to your Kubernetes config file\n- `wazuh.enrollmentPassword`: Password for Wazuh agent enrollment\n\n### Kubernetes Management\n\n```shell\n# List all available Kubernetes clusters\nairnity k8s list clusters\n\n# Generate kubeconfig files for all clusters\nairnity k8s get kubeconfigs\n\n# Use private endpoints for GKE clusters\nairnity k8s get kubeconfigs --private-endpoints\n```\n\n### Authentication\n\n```shell\n# Check and authenticate GCloud credentials\nairnity auth login\n\n# Revoke GCloud tokens\nairnity auth logout\n```\n\n### Docker Registry\n\n```shell\n# Login to GCP Docker registries\nairnity docker login\n```\n\n### Wazuh Security Management\n\n```shell\n# Configure and enroll Wazuh agent\nairnity wazuh configure\n\n# Display real-time Wazuh agent logs\nairnity wazuh print-logs\n\n# Display current Wazuh agent configuration\nairnity wazuh print-config\n\n# Display current Wazuh agent version\nairnity wazuh version\n```\n\n### CLI Updates\n\n```shell\n# Upgrade to the latest version\nairnity upgrade\n\n# Use custom proxy for updates\nairnity upgrade --proxy-url https://my-proxy.example.com\n```\n\n## GPG Keys Generation\n\n```shell\nairnity gpg generate\n```\n\nThe `gpg generate` command automates the creation of a GPG keypair along with subkeys for signing, encryption, and authentication. This process isolates the keys within a temporary `GNUPGHOME` directory, ensuring your default keyring remains untouched. The command will:\n\n- Generate a new master key for certification.\n- Generate subkeys for signing, encryption, and authentication.\n- Export the master key, subkeys, and public key to `.key` files\n- Generate a revocation certificate\n- Copy the generated passphrase to your clipboard for secure storage.\n\nOnce the key generation process is complete, the following files will be available in the temporary directory displayed by the script (e.g., `/tmp/gnupg_202410141642_Fo2GaO`):\n\n- **`master.key`**: This is your master secret key. **Do not** share this key with anyone.\n- **`sub.key`**: This contains your secret subkeys for signing, encryption, and authentication.\n- **`pub.key`**: This is your public key. You can share this with anyone who needs to encrypt messages to you or verify your signatures.\n- **`revoke.asc`**: This is a revocation certificate that can be used to invalidate your keys if they are ever compromised or lost.\n\n### Next Steps: Storing Keys/Passphrase \u0026 import into your keyring\n\nAfter key generation, securely store your master key and passphrase. Import the keys into your keyring and verify they're working properly.\n\nFor cleanup, delete the temporary folder mentioned above (e.g., `/tmp/gnupg_202410141642_Fo2GaO`).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fairnity%2Fairnity-cli-releases","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fairnity%2Fairnity-cli-releases","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fairnity%2Fairnity-cli-releases/lists"}