All Projects → CircleCI-Public → Circleci Cli

CircleCI-Public / Circleci Cli

Licence: mit
Use CircleCI from the command line

Programming Languages

go
31211 projects - #10 most used programming language
golang
3204 projects

Projects that are alternatives of or similar to Circleci Cli

Awesome bot
✅ Validate links in awesome projects
Stars: ✭ 697 (+134.68%)
Mutual labels:  cli, tool, circleci
Tox
Command line driven CI frontend and development task automation tool.
Stars: ✭ 2,523 (+749.49%)
Mutual labels:  cli, continuous-integration, circleci
Carvel Kwt
Kubernetes Workstation Tools CLI
Stars: ✭ 119 (-59.93%)
Mutual labels:  cli, devops, developer-tools
Npkill
List any node_modules directories in your system, as well as the space they take up. You can then select which ones you want to erase to free up space.
Stars: ✭ 5,325 (+1692.93%)
Mutual labels:  cli, tool, developer-tools
Check It Out
A command line interface for Git Checkout. See branches available for checkout.
Stars: ✭ 127 (-57.24%)
Mutual labels:  command-line-tool, cli, developer-tools
Org Formation Cli
Better than landingzones!
Stars: ✭ 471 (+58.59%)
Mutual labels:  cli, devops, tool
Devspace
DevSpace - The Fastest Developer Tool for Kubernetes ⚡ Automate your deployment workflow with DevSpace and develop software directly inside Kubernetes.
Stars: ✭ 2,559 (+761.62%)
Mutual labels:  cli, devops, developer-tools
Escape
Release engineering, life-cycle management and Continuous Delivery of software platforms and artefacts
Stars: ✭ 199 (-33%)
Mutual labels:  devops, continuous-integration, continuous-delivery
Matrix Commander
simple but convenient CLI-based Matrix client app for sending and receiving
Stars: ✭ 90 (-69.7%)
Mutual labels:  command-line-tool, cli, tool
Gita
Manage many git repos with sanity 从容管理多个git库
Stars: ✭ 865 (+191.25%)
Mutual labels:  command-line-tool, cli, developer-tools
Awesome Ci
List of Continuous Integration services
Stars: ✭ 2,737 (+821.55%)
Mutual labels:  devops, developer-tools, continuous-integration
Dnote
A simple command line notebook for programmers
Stars: ✭ 2,192 (+638.05%)
Mutual labels:  command-line-tool, cli, developer-tools
Rocket
Automated software delivery as fast and easy as possible 🚀
Stars: ✭ 217 (-26.94%)
Mutual labels:  devops, continuous-integration, continuous-delivery
Terragrunt
Terragrunt is a thin wrapper for Terraform that provides extra tools for working with multiple Terraform modules.
Stars: ✭ 5,446 (+1733.67%)
Mutual labels:  cli, devops, developer-tools
Werf
The CLI tool gluing Git, Docker, Helm, and Kubernetes with any CI system to implement CI/CD and Giterminism
Stars: ✭ 2,814 (+847.47%)
Mutual labels:  devops, continuous-integration, continuous-delivery
Bbrun
Run Bitbucket Pipelines locally
Stars: ✭ 127 (-57.24%)
Mutual labels:  cli, continuous-integration, continuous-delivery
Anteater
Anteater - CI/CD Gate Check Framework
Stars: ✭ 174 (-41.41%)
Mutual labels:  devops, developer-tools, circleci
Hands On Devops
A hands-on DevOps course covering the culture, methods and repeated practices of modern software development involving Packer, Vagrant, VirtualBox, Ansible, Kubernetes, K3s, MetalLB, Traefik, Docker-Compose, Docker, Taiga, GitLab, Drone CI, SonarQube, Selenium, InSpec, Alpine 3.10, Ubuntu-bionic, CentOS 7...
Stars: ✭ 196 (-34.01%)
Mutual labels:  devops, continuous-integration, continuous-delivery
Httpie
As easy as /aitch-tee-tee-pie/ 🥧 Modern, user-friendly command-line HTTP client for the API era. JSON support, colors, sessions, downloads, plugins & more. https://twitter.com/httpie
Stars: ✭ 53,052 (+17762.63%)
Mutual labels:  cli, devops, developer-tools
Grex
A command-line tool and library for generating regular expressions from user-provided test cases
Stars: ✭ 4,847 (+1531.99%)
Mutual labels:  command-line-tool, cli, tool

circleci-cli

This is CircleCI's command-line application.

Documentation | Code of Conduct | Contribution Guidelines | Hacking

CircleCI GitHub release GoDoc Codecov License

Getting Started

Installation

CircleCI CLI is available on the following package managers:

Homebrew

brew install circleci

Snap

sudo snap install circleci

Chocolatey

choco install circleci-cli -y

Install script

You can also install the CLI binary by running our install script on most Unix platforms:

curl -fLSs https://raw.githubusercontent.com/CircleCI-Public/circleci-cli/master/install.sh | bash

By default, the circleci app will be installed to the /usr/local/bin directory. If you do not have write permissions to /usr/local/bin, you may need to run the above command with sudo:

curl -fLSs https://raw.githubusercontent.com/CircleCI-Public/circleci-cli/master/install.sh | sudo bash

Alternatively, you can install to an alternate location by defining the DESTDIR environment variable when invoking bash:

curl -fLSs https://raw.githubusercontent.com/CircleCI-Public/circleci-cli/master/install.sh | DESTDIR=/opt/bin bash

You can also set a specific version of the CLI to install with the VERSION environment variable:

curl -fLSs https://raw.githubusercontent.com/CircleCI-Public/circleci-cli/master/install.sh | VERSION=0.1.5222 sudo bash

Updating

If you installed the CLI without a package manager, you can use its built-in update command to check for pending updates and download them:

circleci update check
circleci update install

Configure the CLI

After installing the CLI, you must run setup to configure the tool.

$ circleci setup

You should be prompted to enter the CircleCI API Token you generated from the Personal API Token tab

✔ CircleCI API Token:

API token has been set.

✔ CircleCI Host: https://circleci.com

CircleCI host has been set.

Setup complete. Your configuration has been saved.

If you are using this tool on circleci.com. accept the provided default CircleCI Host.

Server users will have to change the default value to your custom address (i.e. circleci.my-org.com).

Note: Server does not yet support config processing and orbs, you will only be able to use circleci local execute (previously circleci build) for now.

Validate A Build Config

To ensure that the tool is installed, you can use it to validate a build config file.

$ circleci config validate

Config file at .circleci/config.yml is valid

Docker

The CLI may also be used without installation by using Docker.

docker run --rm -v $(pwd):/data circleci/circleci-cli:alpine config validate /data/.circleci/config.yml --token $TOKEN

circleci-agent

In order to maintain backwards compatibility with the circleci binary present in builds, some commands are proxied to a program called circleci-agent.

This program must exist in your $PATH as is the case inside of a job.

The following commands are affected:

  • circleci tests split
  • circleci step halt
  • circleci config migrate

Platforms, Deployment and Package Managers

The tool is deployed through a number of channels. The primary release channel is through GitHub Releases. Green builds on the master branch will publish a new GitHub release. These releases contain binaries for macOS, Linux and Windows. These releases are published from (CircleCI)[https://app.circleci.com/pipelines/github/CircleCI-Public/circleci-cli] using (GoReleaser)[https://goreleaser.com/].

Homebrew

We publish the tool to Homebrew. The tool is part of homebrew-core, and therefore the maintainers of the tool are obligated to follow the guidelines for acceptable Homebrew formulae. You should familairise yourself with the guidelines before making changes to the Homebrew deployment system.

The particular considerations that we make are:

  1. Since Homebrew doesn't "like tools that upgrade themselves", we disable the circleci update command when the tool is released through homebrew. We do this by defining the PackageManager constant to homebrew, which allows us to disable the update command at runtime.
  2. We want to avoid every push to master from creating a Pull Request to the circleci formula on Homebrew. We want to avoid overloading the Homebrew team with pull requests to update our formula for small changes (changes to docs or other files that don't change functionality in the tool).

Snap

We publish Linux builds of the tool to the Snap package manager.

Further package information is available on Snap website.

Contributing

Development instructions for the CircleCI CLI can be found in HACKING.md.

More

Please see the documentation or circleci help for more.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].