Skip to content
Docs
Cancel

CircleCI CLI 入門

概要

開発作業の大部分をターミナルで行いたい場合は、CircleCI CLI をインストールして CircleCI 上のプロジェクトを操作するとよいでしょう。 このドキュメントでは、CircleCI プロジェクトの初期化や操作を主にターミナルから行うための手順を説明します。 Please note that our server offering only supports a legacy version of the CLI. You can find more information on how to install that here: https://circleci.com/docs/2.0/local-cli/#using-the-cli-on-circleci-server.

前提条件

  • Unix マシン (Mac または Linux) を使用している。 Windows にも CircleCI CLI ツールのインストールは_可能_ですが、現在はベータ版であり、Unix 版ほどの機能は完備されていません。
  • CI/CD、CircleCI サービスの機能とコンセプトについての基礎知識がある。
  • GitHub アカウントを持っている。
  • CircleCI アカウントを持っている。
  • ターミナルを開いており、使用可能である。
  • オプション: Github の Hub コマンドライン ツールがインストールされている (Web UI ではなくコマンド ラインから Github を使用できます)。 Hub のインストール方法については、こちらを参照してください。

上記の前提条件に不明点がある方や CircleCI プラットフォームの初心者は、先に入門ガイドまたはコンセプトに関するドキュメントをお読みになることをお勧めします。

手順

Hub CLI のインストールとセットアップが完了している場合は、以下のコマンドを実行するだけです。

Git リポジトリを初期化する

次に、ログインと Hub CLI の承認に関するプロンプトに従います。

基本中の基本から始めましょう。 プロジェクトを作成し、Git リポジトリを初期化します。 各ステップについては、以下のコード ブロックを参照してください。

cd ~ # ホーム ディレクトリに移動します
mkdir foo_ci # "foo_ci" という名前のフォルダーにプロジェクトを作成します
cd foo_ci # 新しい foo_ci フォルダーにディレクトリを変更します
cd ~ # ホーム ディレクトリに移動します
mkdir foo_ci # "foo_ci" という名前のフォルダーにプロジェクトを作成します
cd foo_ci # 新しい foo_ci フォルダーにディレクトリを変更します
git init # git リポジトリを作成します
touch README.md # リポジトリに配置するファイルを作成します
echo 'Hello World!' >> README.md
git add . # コミットするすべてのファイルをステージングします
git commit -m "Initial commit" # 最初のコミットを実行します

Git リポジトリを VCS に接続する

これで、Git リポジトリが VCS に接続され、 VCS 上のリモート (“origin”) がローカルでの作業内容と一致するようになります。

Great! 前述の手順で Git リポジトリがセットアップされ、「Hello World!」と記述された 1 つのファイルが格納されました。 ローカルの Git リポジトリは、バージョン管理システム (GitHub または BitBucket) に接続する必要があります。 Let’s do that now.

If you have installed and setup the Hub CLI, you can simply run:

hub create

次に、インストール後のセットアップ手順を実行します。

Hub CLI を使用していない場合は、GitHub にアクセスしてログインし、新しいリポジトリを作成します。 指示に従ってコミットし、リモートにプッシュします。 この操作は通常、以下のようなコマンドになります。

git remote add origin git@github.com:<YOUR_USERNAME>/foo_ci.git
git push --set-upstream origin master

You now have a git repo that is connected to a VCS. The remote on your VCS (“origin”) now matches your local work.

CircleCI CLI をダウンロードして準備する

ここからは、プロジェクト ディレクトリに設定ファイルを作成します。

次に、CircleCI CLI をインストールし、いくつかの機能を試してみます。 CLI を Unix マシンにインストールするには、ターミナルで以下のコマンドを実行します。

curl -fLSs https://circle.ci/cli | bash

新しく作成した config.yml ファイルを開き、以下の内容を貼り付けます。

Now run the setup step after the installation:

circleci setup

ここで API トークンを要求されます。 アカウントの設定ページに移動し、[Create New Token (新しいトークンを作成する)] をクリックします。 トークンに名前を付け、生成されたトークン文字列をコピーして、安全な場所に保存します。

CLI に戻って API トークンを貼り付ければセットアップは完了です。

最初の設定ファイルを準備してバリデーションする

“build” ジョブをローカルで実行してみます。

Now it’s time to create a configuration file in our project directory.

cd ~/foo_ci # カレント ディレクトリが foo_ci フォルダーであることを確認します
mkdir .circleci # ".circleci" という名前のディレクトリを作成します
cd .circleci # カレント ディレクトリを新しいディレクトリに変更します
touch config.yml # "config.yml" という名前の YAML ファイルを作成します

上記のコマンドにより、.circleci フォルダーが作成され、そこに設定ファイルが格納されます。

Open the newly created config.yml file and paste the following contents into it.

version: 2.0
jobs:
  build:
    docker:
      - image: circleci/ruby:2.4.2-jessie-node
    steps:
      - checkout
      - run: echo "Hello World"

ここで、この構成が有効であるかどうかをバリデーションします。 プロジェクトのルートで、以下のコマンドを実行します。

circleci config validate

ブラウザーで CircleCI に戻ると、[Start building (ビルドの開始)] をクリックしてビルドを実行できます。

circleci config validate --help

VCS にプッシュする前にジョブをテストする

CircleCI CLI では、コマンド ラインからジョブをローカルでテストできます。 VCS にプッシュする必要はありません。 設定ファイル内のジョブに問題があることがわかっている場合は、プラットフォームでクレジットや時間を消費するよりも、ローカルでテストやデバッグを行う方が賢明です。

Try running the “build” job locally:

circleci local execute

これで、指定した Docker イメージ (この場合は circleci/ruby::2.4.2-jessie-node) がプル ダウンされ、ジョブが実行されます。 使用している Docker イメージのサイズによっては、多少の時間がかかります。

ターミナルには大量のテキストが表示されるはずです。 出力の最後の数行は以下のようになります。

====>> Checkout code
  #!/bin/bash -eo pipefail
mkdir -p /home/circleci/project && cp -r /tmp/_circleci_local_build_repo/. /home/circleci/project
====>> echo "Hello World"
  #!/bin/bash -eo pipefail
echo "Hello World"
Hello World
Success!

リポジトリを CircleCI に接続する

このステップでは、ターミナルを離れる必要があります。 [Add Projects (プロジェクトの追加)] ページにアクセスします。 コードをプッシュするたびに CI が実行されるようにプロジェクトをセットアップします。

プロジェクトのリストから目的のプロジェクト (“foo_ci” または GitHub で付けた名前) を見つけ、[Set Up Project (プロジェクトのセットアップ)] をクリックします。 次に、ターミナルに戻り、最新の変更を GitHub にプッシュします (config.yml ファイルの追加分)。

git add .
git commit -m "add config.yml file"
git push

Returning to CircleCI in your browser, you can now click “start building” to run your build.

次のステップ

このドキュメントでは、CircleCI CLI ツールの使用を開始するための手順を簡単に説明してきました。 CircleCI CLI は、さらに複雑な機能も提供しています。

  • Orbs の作成、表示、バリデーション、パブリッシュ
  • CircleCI GraphQL API のクエリ
  • 複雑な設定ファイルのパッケージ化と処理

詳細については、CircleCI のローカル CLI に関するドキュメントを参照してください。


Help make this document better

This guide, as well as the rest of our docs, are open-source and available on GitHub. We welcome your contributions.

Creative Commons License
CircleCI Documentation by CircleCI is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.