{"id":19347182,"url":"https://github.com/dcos/dcos-cli","last_synced_at":"2025-05-16T07:06:56.539Z","repository":{"id":23294201,"uuid":"26653348","full_name":"dcos/dcos-cli","owner":"dcos","description":"The command line for DC/OS.","archived":false,"fork":false,"pushed_at":"2023-05-22T21:58:06.000Z","size":31898,"stargazers_count":225,"open_issues_count":16,"forks_count":117,"subscribers_count":77,"default_branch":"master","last_synced_at":"2025-04-12T04:47:24.800Z","etag":null,"topics":["cli","dcos","dcos-cli","dcos-ux-guild","golang"],"latest_commit_sha":null,"homepage":"https://docs.d2iq.com/mesosphere/dcos/latest/cli/","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/dcos.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null}},"created_at":"2014-11-14T19:11:48.000Z","updated_at":"2025-04-09T02:07:01.000Z","dependencies_parsed_at":"2022-07-25T12:32:47.769Z","dependency_job_id":"552c4b21-e004-4e01-8799-82b9ae46f470","html_url":"https://github.com/dcos/dcos-cli","commit_stats":null,"previous_names":[],"tags_count":83,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dcos%2Fdcos-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dcos%2Fdcos-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dcos%2Fdcos-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dcos%2Fdcos-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dcos","download_url":"https://codeload.github.com/dcos/dcos-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253708831,"owners_count":21951059,"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":["cli","dcos","dcos-cli","dcos-ux-guild","golang"],"created_at":"2024-11-10T04:14:39.377Z","updated_at":"2025-05-16T07:06:51.521Z","avatar_url":"https://github.com/dcos.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DC/OS Command Line Interface [![Build Status](https://jenkins.mesosphere.com/service/jenkins/buildStatus/icon?job=public-dcos-cluster-ops/mesosphere-dcos-cli/integration-tests)](https://jenkins.mesosphere.com/service/jenkins/job/public-dcos-cluster-ops/job/mesosphere-dcos-cli/job/integration-tests/)\n\nThe DC/OS Command Line Interface (CLI) is a cross-platform command line\nutility that provides a user-friendly yet powerful way to manage DC/OS\nclusters.\n\n## Installation and usage\n\nIf you're a **user** of DC/OS, please follow the [installation\ninstructions](https://docs.d2iq.com/mesosphere/dcos/latest/cli/install/). Otherwise,\nfollow the instructions below to set up your development environment.\n\nDetailed help and usage information is available through the dcos help\ncommand and for specific subcommands through `dcos \u003csubcommand\u003e --help`.\n\nAdditional documentation for the CLI and for the DC/OS in general is\navailable in the [DC/OS docs](https://dcos.io/docs/).\n\n## Development setup\n\n### Requirements\n\n1.  [git](http://git-scm.com) must be installed to download the source\n    code for the DC/OS CLI.\n2.  [go](https://golang.org/dl/) 1.12+ or Docker.\n3.  [win-bash](https://sourceforge.net/projects/win-bash/files/shell-complete/latest)\n   must be installed if you are using Windows in order to run setup scripts\n   from the Makefile.\n\n### Instructions\n\n1.  Clone git repo for the dcos cli:\n\n        git clone git@github.com:dcos/dcos-cli.git\n\n2.  Change directory to the repo directory:\n\n        cd dcos-cli\n\n3.  Build the binary (using Docker):\n\n        make\n\n    or Using Go (1.12+):\n\n        export NO_DOCKER=1\n        make\n\n## Using the DC/OS CLI\n\nThe DC/OS CLI will be built in the directory `build/\u003cplatform\u003e/`.\n\n## Running tests\n\n### Unit tests\n\n    make test\n\n### Integration tests\n\nYou need to have a running DC/OS cluster in order to run the integration tests.\nUsing a Python virtual environment is recommended.\n\n    export DCOS_TEST_DEFAULT_CLUSTER_USERNAME=\u003cusername to access the cluster\u003e\n    export DCOS_TEST_DEFAULT_CLUSTER_PASSWORD=\u003cpassword to access the cluster\u003e\n    export DCOS_TEST_DEFAULT_CLUSTER_HOST=\u003cIP or domain of the cluster\u003e\n    cd tests\n    pip install -r requirements.txt\n    pytest integration\n\n## Releasing\n\nReleasing a new version of the DC/OS CLI is done through an\n[automated Jenkins\nbuild](https://jenkins.mesosphere.com/service/jenkins/job/public-dcos-cluster-ops/job/mesosphere-dcos-cli/job/release/)\nwhich is triggered automatically for new tags and on pushes to master.\n\nThe latest binaries (built from the latest tag) are published to:\n\n- https://downloads.dcos.io/cli/releases/binaries/dcos/linux/x86-64/latest/dcos\n- https://downloads.dcos.io/cli/releases/binaries/dcos/darwin/x86-64/latest/dcos\n- https://downloads.dcos.io/cli/releases/binaries/dcos/windows/x86-64/latest/dcos.exe\n\nThe testing binaries (built from the master branch continuously) are published to:\n\n- https://downloads.dcos.io/cli/testing/binaries/dcos/linux/x86-64/master/dcos\n- https://downloads.dcos.io/cli/testing/binaries/dcos/darwin/x86-64/master/dcos\n- https://downloads.dcos.io/cli/testing/binaries/dcos/windows/x86-64/master/dcos.exe\n\nThe release proces is described [here](https://github.com/dcos/dcos-cli/blob/master/design/release.md#release-process)\n\n## Contributing\n\nContributions are always welcome! Please refer to our [contributing guidelines](CONTRIBUTING.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdcos%2Fdcos-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdcos%2Fdcos-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdcos%2Fdcos-cli/lists"}