{"id":20802352,"url":"https://github.com/astarte-platform/astartectl","last_synced_at":"2025-05-07T00:46:30.837Z","repository":{"id":37823025,"uuid":"208264089","full_name":"astarte-platform/astartectl","owner":"astarte-platform","description":"Astarte command line client utility","archived":false,"fork":false,"pushed_at":"2025-02-17T17:01:05.000Z","size":1020,"stargazers_count":25,"open_issues_count":14,"forks_count":18,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-31T04:41:13.853Z","etag":null,"topics":["go-cli","iot"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/astarte-platform.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-09-13T12:52:17.000Z","updated_at":"2025-02-10T14:43:05.000Z","dependencies_parsed_at":"2023-10-14T04:36:43.736Z","dependency_job_id":"9dbf4b06-e0ea-4f77-958e-066f496bc03b","html_url":"https://github.com/astarte-platform/astartectl","commit_stats":null,"previous_names":[],"tags_count":35,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astarte-platform%2Fastartectl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astarte-platform%2Fastartectl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astarte-platform%2Fastartectl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astarte-platform%2Fastartectl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/astarte-platform","download_url":"https://codeload.github.com/astarte-platform/astartectl/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252793568,"owners_count":21805055,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["go-cli","iot"],"created_at":"2024-11-17T18:30:45.633Z","updated_at":"2025-05-07T00:46:30.832Z","avatar_url":"https://github.com/astarte-platform.png","language":"Go","readme":"# astartectl\n\nCommand line utility to manage Astarte\n\n## Installation\n\n`astartectl` requires at least Go 1.18.\n\n### Using homebrew\n\nIf you are using [homebrew](https://brew.sh/) on your system, you can install `astartectl` out of its tap:\n\n```bash\nbrew tap astarte-platform/astarte\nbrew update\nbrew install astartectl\n```\n\n### Using binaries from Github Release\n\nYou can download latest `astartectl` binaries for all platforms from [GitHub Releases](https://github.com/astarte-platform/astartectl/releases).\n\nMove the binaries to your `$PATH` folder or set your `$PATH` to the folder where `astartectl` is run from.\n\n## Configuration\n\n`astartectl` works with a context-based configuration. If you are familiar with how `kubectl` works, you'll\nfind most of its concepts in `astartectl` configuration system. There are two main entities in `astartectl`\nconfiguration: `cluster` and `context`.\n\nA `cluster` represents an Astarte Cluster. It might contain housekeeping credentials, but most of all it should\nbear the API URLs necessary to interact with the cluster. `astartectl config clusters` allows you to manipulate\navailable clusters.\n\nA `context` represents a configuration for `astartectl`, which references a `cluster` and, optionally an Astarte\nRealm. A `context` with no realm associated is meant to interact with Housekeeping (for, e.g., creating a Realm).\n`astartectl config contexts` allows you to manipulate available clusters.\n\n### Active context\n\nAt any time, when invoking `astartectl` without any further configuration options, the active `context` will be\nused. There is only one context available at a time, which can be queried by issuing `astartectl config current-context`.\nThe context can be changed at any time using `astartectl config set-current-context`.\n\n### Fetching context information\n\nIn most cases, if you have access to the Kubernetes Cluster hosting your Astarte Cluster, you will be able to\nautomatically build the `cluster` entry in the configuration. This can be done through the\n`astartectl cluster instances get-cluster-config` command, which creates a `cluster` entry based on the Astarte\ninstance installed on the Kubernetes cluster referenced by your current `kubectl` context, if any.\n\nIn the same fashion, creating a new Realm automatically creates a new configuration `context`, if a private\nkey and all necessary information are provided.\n\n## Usage\n\nRun `astartectl` to see available commands.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastarte-platform%2Fastartectl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fastarte-platform%2Fastartectl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastarte-platform%2Fastartectl/lists"}