Overview

Server v2.x

Server Admin

実行環境

CircleCI では、プライマリジョブスケジューラとして Nomad を使用します。 Refer to our Introduction to Nomad Cluster Operation to learn more about the job scheduler and how to perform basic client and cluster operations.

By default, CircleCI Nomad clients automatically provision containers according to the image configured for each job in your .circleci/config.yml file.

Architecture

Figure 1.1 illustrates CircleCI core components, build orchestration services, and executors. CircleCI API は、全面的な機能を備えた RESTful API で、CircleCI のすべての情報にアクセスでき、すべてのアクションをトリガーできます。

Within the CircleCI UI is the Insights page, which acts as a dashboard showing the health of all repositories you are following including:

平均ビルド時間
平均キュー時間
last build time
成功率
parallelism

CircleCI は、Services と Nomad クライアントという 2つのプライマリコンポーネントで構成されます。任意の数の Nomad クライアントがジョブを実行し、Services と通信します。 All components must access GitHub or your hosted instance of GitHub Enterprise on the network, as illustrated below.

Services マシン

The Services machine must not be restarted and may be backed up using VM snapshotting. If you must restart the Services machine, do so only as a last resort, because a restart will result in downtime. Refer to the Backup and Recovery chapter for instructions.

DNS resolution may point to the IP address of the Services machine. It is also possible to point to a load balancer, for example an ELB in AWS. The following table describes the ports used for traffic on the Service machine:

ソース	ポート	用途
エンドユーザー	80, 443, 4434	HTTP/HTTPS トラフィック
管理者	22	SSH
管理者	8800	管理者コンソール
Builder Boxes	すべてのトラフィック、すべてのポート	内部通信
GitHub (Enterprise または .com)	80、443	受信 Web フック

Nomad クライアント

Nomadクライアントは実行後に状態を保持しないため、必要に応じてコンテナ数を増減することができます。

すべてのビルドを処理できる十分な数の Nomad クライアントが確実に実行されるようにするには、キューイングされているビルドを追跡し、必要に応じて Nomad クライアントマシンの数を増やして負荷を分散させます。 For more on tracking metrics see Monitoring Your Installation.

各マシンには、ビルドを調整するために、それぞれ 2つの vCPU と 4GB のメモリが予約されています。そのうえで、残りのプロセッサーとメモリでコンテナが作成されます。マシンの規模が大きくなれば、その分多くのコンテナを実行することができますが、調整用に予約してある 2 基以外に使用できるコアの数によって制限されます。

The maximum machine size for a Nomad client is 128GB RAM/ 64 CPUs, contact your CircleCI account representative to request use of larger machines for Nomad Clients.

以下の表に、Nomad クライアントで使用されるポートを示します。

ソース	ポート	用途
エンドユーザー	64535-65535	ビルドへの SSH 接続機能
管理者	80 または 443	CCI API アクセス
管理者	22	SSH
Services マシン	すべてのトラフィック、すべてのポート	内部通信
Nomad クライアント (それ自身を含む)	すべてのトラフィック、すべてのポート	内部通信

GitHub

CircleCI uses GitHub or GitHub Enterprise credentials for authentication which, in turn, may use LDAP, SAML, or SSH for access. つまり、CircleCI は、一元管理された SSO インフラストラクチャでサポートされる認証を継承します。

CircleCI では、セットアップ後の URL やバックエンドの GitHub インスタンスの変更には対応していません。以下の表に、GitHub を実行するマシンで Services および Nomad クライアントインスタンスと通信する際に使用されるポートを示します。

ソース	ポート	用途
Services	22	Git アクセス
Services	80、443	API アクセス
Nomad クライアント	22	Git アクセス
Nomad クライアント	80、443	API アクセス

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

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

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

サポートが必要ですか

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

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

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