• Stars
    star
    224
  • Rank 173,704 (Top 4 %)
  • Language
    Go
  • License
    Apache License 2.0
  • Created over 9 years ago
  • Updated about 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

The command line for DC/OS.

DC/OS Command Line Interface Build Status

The DC/OS Command Line Interface (CLI) is a cross-platform command line utility that provides a user-friendly yet powerful way to manage DC/OS clusters.

Installation and usage

If you're a user of DC/OS, please follow the installation instructions. Otherwise, follow the instructions below to set up your development environment.

Detailed help and usage information is available through the dcos help command and for specific subcommands through dcos <subcommand> --help.

Additional documentation for the CLI and for the DC/OS in general is available in the DC/OS docs.

Development setup

Requirements

  1. git must be installed to download the source code for the DC/OS CLI.
  2. go 1.12+ or Docker.
  3. win-bash must be installed if you are using Windows in order to run setup scripts from the Makefile.

Instructions

  1. Clone git repo for the dcos cli:

    git clone [email protected]:dcos/dcos-cli.git
    
  2. Change directory to the repo directory:

    cd dcos-cli
    
  3. Build the binary (using Docker):

    make
    

    or Using Go (1.12+):

    export NO_DOCKER=1
    make
    

Using the DC/OS CLI

The DC/OS CLI will be built in the directory build/<platform>/.

Running tests

Unit tests

make test

Integration tests

You need to have a running DC/OS cluster in order to run the integration tests. Using a Python virtual environment is recommended.

export DCOS_TEST_DEFAULT_CLUSTER_USERNAME=<username to access the cluster>
export DCOS_TEST_DEFAULT_CLUSTER_PASSWORD=<password to access the cluster>
export DCOS_TEST_DEFAULT_CLUSTER_HOST=<IP or domain of the cluster>
cd tests
pip install -r requirements.txt
pytest integration

Releasing

Releasing a new version of the DC/OS CLI is done through an automated Jenkins build which is triggered automatically for new tags and on pushes to master.

The latest binaries (built from the latest tag) are published to:

The testing binaries (built from the master branch continuously) are published to:

The release proces is described here

Contributing

Contributions are always welcome! Please refer to our contributing guidelines.

More Repositories

1

dcos

DC/OS - The Datacenter Operating System
Python
2,341
star
2

dcos-ui

The UI for The Datacenter Operating System
TypeScript
255
star
3

lashup

A distributed CRDT store with multicast and failure detector capabilities
Erlang
210
star
4

examples

DC/OS examples
Shell
138
star
5

metronome

Apache Mesos framework for scheduled jobs
Scala
112
star
6

demos

Repository with DC/OS demos to show specific use cases, usually industry specific.
TSQL
102
star
7

dcos-e2e

Spin up and manage DC/OS clusters in test environments
Python
61
star
8

cosmos

Provides an API for the orderly, harmonious, and complete management of DC/OS service packages
Scala
58
star
9

dcos-net

A networking layer of DC/OS
Erlang
45
star
10

adminrouter

Nginx config running on the DCOS master servers to provide a proxy for the admin parts of the cluster
38
star
11

shakedown

DC/OS test harness
Python
29
star
12

dcos-ansible

Ansibles roles to manage a Mesosphere DC/OS clusters life cycle
Python
29
star
13

dcos-website

Source for the official DC/OS website
JavaScript
25
star
14

prometheus-alert-rules

22
star
15

dcos-oauth

DC/OS OAuth Service (only used up to DC/OS version 1.12)
Go
22
star
16

dcos-log

dcos-log: is a HTTP server for systemd journal events
Go
18
star
17

dcos-mesos-modules

Mesos Modules used in DC/OS
C++
17
star
18

dcos-go

DC/OS golang shared libraries
Go
15
star
19

dcos-launch

Turn-key deployments of DC/OS on AWS (template and onprem), Azure, and GCE
Python
15
star
20

grafana-dashboards

Official DC/OS Grafana dashboards
14
star
21

exhibitor

ZooKeeper co-process for instance monitoring, backup/recovery, cleanup and visualization.
Java
13
star
22

pve

Erlang
8
star
23

client-go

DC/OS Client for Go.
Go
7
star
24

dcos-test-utils

Utilities for testing and interacting with DC/OS services
Python
6
star
25

dcos-diagnostics

DC/OS Distributed Diagnostics Tool & Aggregation Service
Go
6
star
26

bouncer

The DC/OS identity and access management service (IAM)
Python
6
star
27

dcos-images

Repository is used to qualify DC/OS releases on multiple operating systems.
Shell
4
star
28

dcos-http-cli

HTTP requests against your DC/OS cluster!
Go
3
star
29

mesos_state

Erlang
3
star
30

raml-validator-loader

A webpack plugin that converts RAML rules into pure javascript-only validation routines
JavaScript
3
star
31

kminuteman

C
2
star
32

dcos-ui-update-service

DC/OS component responsible for updating dcos-ui served version
Go
2
star
33

dcos-core-cli

Core plugin for the DC/OS CLI
Python
2
star
34

dcos-cni

DC/OS specific CNI plugins.
Go
2
star
35

terraform-aws-spot-instance

HCL
2
star
36

sbt-dcos

An SBT plugin for common build settings of Scala projects in DC/OS.
Scala
2
star