コンテナランナーのインストール (Kubernetes)

クラウド

Server v4.x

Server v3.x

このページの内容

このページでは、CircleCI コンテナランナーのインストール手順を説明します。

このページはセルフホストランナーのインストールの続きです。下記の手順を進めるには、既存の CircleCI 名前空間とリソースクラスが必要です。これは、 CircleCI Web アプリで Self-Hosted Runners に移動して実行できます ( Web アプリのインストールのドキュメントを参照)。また、 CLI もご使用いただけます。

インストール手順

helm repo add container-agent https://packagecloud.io/circleci/container-agent/helm を実行してコンテナランナーの Helm リポジトリを追加します。
helm repo update を実行します。
kubectl create namespace circleci を実行し、 circleci Kubernetes 名前空間を作成します。

values.yaml ファイルという以下を含むファイルを作成します。

agent:
  resourceClasses:
    namespace/my-rc:
      token: <resource_class_token>

helm install container-agent container-agent/container-agent -n circleci -f values.yaml を実行します。

コンテナランナーの設定例

クラスタにコンテナランナーをインストールしたら、Docker Executor を使ってインストールを検証する CircleCI ジョブを作成し、トリガーします。セルフホストランナーを使って実行する特定のジョブについて、以下のフィールドを設定する必要があります。

image:
resource_class: <namespace>/<resource-class>

ジョブのセットアップの簡単な例 (cimg/base:2021.11 は、よく使用される CircleCI の Docker イメージです):

version: 2.1

jobs:
  build:
    docker:
      - image: cimg/base:2021.11
    resource_class: <namespace>/<resource-class>
    steps:
      - checkout
      - run: echo "Hi I'm on Runners!"

workflows:
  build-workflow:
    jobs:
      - build

setup_remote_docker を使用する既存のジョブは 使用しないでください (詳細は以下のコンテナイメージのビルドのセクションを参照)。

トラブルシューティング

セルフホストランナーのトラブルシューティングガイドのコンテナランナーのトラブルシューティングのセクションを参照してください。

関連リソース

ドキュメントの改善にご協力ください

このガイドは、CircleCI の他のドキュメントと同様にオープンソースであり、 GitHub でご利用いただけます。ご協力いただき、ありがとうございます。

このページの編集をご提案ください (最初に「コントリビューションガイド」をご覧ください)。
ドキュメントの問題点を報告する、またはフィードバックやコメントを送信するには、GitHub で issue を作成してください。
CircleCI は、ユーザーの皆様の弊社プラットフォームにおけるエクスペリエンスを向上させる方法を常に模索しています。フィードバックをお寄せいただける場合は、リサーチコミュニティにご参加ください。

サポートが必要ですか

CircleCI のサポートエンジニアによる、サービスに関する問題、請求およびアカウントについての質問への対応、設定の構築に関する問題解決のサポートを行っています。サポートチケットを送信して、CircleCI のサポートエンジニアにお問い合わせください。日本語でお問い合わせいただけます。

または、サポートサイトから、サポート記事やコミュニティフォーラム、トレーニングリソースをご覧いただけます。

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