Hello World

このページでは、ユーザー登録後に CircleCI 2.x で Linux、Android、macOS プロジェクトの基本的なビルドを実行するための方法について解説しています。

Hello-Build Orb を使う

GitHub または Bitbucket のローカルリポジトリのルートディレクトリに .circleci ディレクトリを作成します。
.circleci ディレクトリに以下の内容を含む config.yml ファイルを追加し、hello-build orb をインポートします。

version: 2.1

orbs:
    hello: circleci/hello-build@0.0.7 # circleci/buildpack-deps Docker イメージを使います

workflows:
    "Hello Workflow":
        jobs:
          - hello/hello-build

変更のコミットやプッシュは、ビルド実行のトリガーになります。 CircleCI で初めてプロジェクトを作成する場合は、プロジェクトページにアクセスし、[Add Project] ボタンをクリックします。その後プロジェクト名の横にある [Bulid Project] ボタンをクリックしてください。

Echo Hello World を実行する `build` ジョブ

Docker executor を使い Node コンテナをスピンアップし、シンプルな echo コマンドを実行する build ジョブを追加します。

以下の内容を .circleci/config.yml ファイルに追加します。 Docker executors は、node:4.8.2 の部分を希望の Docker イメージに置き換えます。

version: 2
jobs:
  build:
    docker: # Executor タイプです。他に machine、macOS という実行タイプを指定できます
      - image: circleci/node:4.8.2 # プライマリコンテナです。このなかでジョブコマンドが実行されます
    steps:
      - checkout # プロジェクトのディレクトリにあるコードをチェックアウトします
      - run: echo "hello world" # 「echo」コマンドを実行します

注： macOS executors では、一部の設定が異なります。 iOS のプロジェクトを立ち上げる方法は、iOS チュートリアルにアクセスし、macOS の設定例を参考にしてください。

CircleCI はソースコードを取得 (チェックアウト) して “Hello World” と出力し、ジョブページにビルド成功を意味する緑色のマークが付いた項目を残します。GitHub や Bitbucket のコミットページにも緑色のチェックマークを追加します。

注：ファイルの拡張子に .yaml を使うと、No Config Found エラーが発生します。ファイルの拡張子で .yml を使うことで、このエラーは解消されます。

プロジェクトをフォローする

自身がリポジトリにプッシュした新しいプロジェクトは自動的にフォローし、メール通知が有効になると同時にダッシュボードにはそのプロジェクトが表示されるようになります。 CircleCI のプロジェクトページでは、選択した Org の各プロジェクトについて、手動でフォローとフォロー解除もできます。[Add Project] を選び、プロジェクト名の横にある [Follow Project] ボタンもしくは [Unfollow Project] ボタンをクリックしてください。

Org の切り替え

画面左上に、Org を切り替えるメニューがあります。

SWITCH ORGANIZATION メニュー

プロジェクトが表示されなかったり、目的のビルドではないものが表示される場合は、画面左上にある Org を確認してください。もし左上に見えるのがあなたのユーザー名 my-user だったとすると、my-user に属する GitHub プロジェクトだけが [Add Projects] の下に表示されることになります。 GitHub のプロジェクト名 your-org/project をビルドしたいということであれば、画面左上のエリアをクリックすると表示される [SWITCH ORGANIZATION] メニューから目的の your-org に切り替えます。

次のステップは？

CircleCI 2.0 の設定方法や .circleci/config.yml ファイルにおける重要度の高い要素についての説明はコンセプトページで確認できます。
パラレルジョブ、シーケンシャルジョブ、スケジューリングされたジョブ、あるいは承認して処理を続行する Workflows の例については、Workflows ページを参考にしてください。
CircleCI の設定方法や CircleCI のビルド済み Docker イメージのページでは、設定ファイルにおけるキーやビルド済みイメージについて具体的に説明しています。

Search Results for ""