よくあるご質問
このページの内容
- GitHub Enterprise の URL をダウンタイムなく移動または変更できますか？
- ビルドコンテナの現在の状況を監視することはできますか？
- 管理者ユーザーの追加方法を教えてください。
- Nomad クライアントを安全にシャットダウンするには？
- GitHub の認証テストに失敗してしまいます。
- CircleCI を HTTPS で運用できますか？
- リソースごとに terraform destroy しないのはなぜですか？
- Nomad クライアントは何らかのデータを保持しますか？
- TLS の設定に失敗しているようですが、どこを確認すればよいですか。
- Replicated 使用時の管理コンソールをデバッグする方法が知りたい。
- 1. Replicated がインストールされているかを確認する
- 2. Replicated と CircleCI を再起動する
- 3. Replicated へのログインを試す
- 4. Replicated のログをチェックする
- 5. 現在実行している Docker コンテナを確認する
| CircleCI Server version 2.x は、リリースのサポートが終了しています。 リリースがサポートされているバージョンへのアップグレードについては、お客様のアカウントチームにご相談ください。 |
このドキュメントはオンプレミス版 CircleCI Server のシステム管理者を対象としています。
ここでは、よくあるご質問への回答とトラブルシューティングのヒントを紹介します。
GitHub Enterprise の URL をダウンタイムなく移動または変更できますか？
それはできません。CircleCI と GitHub 認証との統合における性質上、本番環境での稼動後に GHE インスタンスのドメインを変更するべきではありません。 ダウンタイムなく GitHub を再デプロイすると、CircleCI のインスタンスが破損します。 GitHub のインスタンスを移動する場合は、サポートにご連絡ください。
ビルドコンテナの現在の状況を監視することはできますか？
できます。詳細は、 Nomad クラスタの操作ガイドを参照してください。 AWS の追加コンテナの監視を有効にする方法については、 インストール後の監視 を参照してください。
管理者ユーザーの追加方法を教えてください。
CircleCI に登録した最初のユーザーが自動的に管理者として設定されます。 管理者ユーザーの追加は、 https://[domain-to-your-installation]/admin/users の Admin にある Users のページ から行えます。
Nomad クライアントを安全にシャットダウンするには？
「Nomad クラスタの運用方法」を参照してください。
GitHub の認証テストに失敗してしまいます。
GitHub Enterprise サーバーが SSL の中間証明書を返さないことが原因です。 https://www.ssllabs.com/ssltest/analyze.html で、GitHub Enterprise のインスタンスを確認してみてください。取得不可能な中間証明書の情報などが調べられます。 openssl のようなコマンドを使うと、サーバーの完全な証明書チェーンを取得することができます。
一度設定に成功した後に設定画面に戻ると、認証に失敗する場合があります。 秘密が暗号化されたため、戻ると失敗します。
CircleCI を HTTPS で運用できますか？
CircleCI は起動時に自己署名証明書を生成しますが、これは管理コンソールに対してのみ使われ、CircleCI アプリケーション自体に使われるものではありません。 CircleCI を HTTPS で運用したい場合は、管理コンソールの SETTINGS にある Privacy セクションで証明書を指定してください。
リソースごとに terraform destroy しないのはなぜですか？
CircleCI では、AWS で終端保護を行うようにサービスボックスを設定し、S3 バケットに書き込みます。 リソースごとに terraform destroy したい場合は、手動でそのインスタンスを削除するか、circleci.tf ファイル内でインスタンス削除保護 (termination protection) をオフに設定してください。 さらに、terraform install によって生成された AWS S3 Bucket を空にする必要もあります。
Nomad クライアントは何らかのデータを保持しますか？
どんなデータも残らないよう破棄されますのでご安心ください。
TLS の設定に失敗しているようですが、どこを確認すればよいですか。
鍵が非暗号化 PEM 形式であることと、その証明書のチェーン全体が間違いなく下記のようになっていることを確認してください。
-----BEGIN CERTIFICATE-----
your_domain_name.crt
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
intermediate 1
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
intermediate 2
-----END CERTIFICATE-----
...Replicated 使用時の管理コンソールをデバッグする方法が知りたい。
CircleCI の管理コンソールは、Replicated をベースとしています。 管理コンソールで問題があるときにデバッグする方法をいくつか紹介します。
1. Replicated がインストールされているかを確認する
まずは Replicated 用の CLI ツールが間違いなくインストールされていることを以下のコマンドで確認してください。
replicated -version2. Replicated と CircleCI を再起動する
Replicated サービスの再起動します。 Ubuntu 14.04 の場合、サービスボックスで下記のコマンドを実行すると再起動できます。
sudo service replicated-ui restart
sudo service replicated restart
sudo service replicated-operator restartUbuntu 16.04 の場合は、以下のコマンドを実行します。
sudo systemctl restart replicated-ui
sudo systemctl restart replicated
sudo systemctl restart replicated-operator次に、CircleCI アプリを再起動してください。サービスボックスの管理者画面 (例えば、 <your-circleci-hostname>.com:8800 ) にアクセスし、「Stop Now」と「Start Now」で再起動してください。
3. Replicated へのログインを試す
Replicated にログインできるか確認してください。 ログインするにはサービスボックスで下記のコマンドを実行します。 パスワードを入力するよう求められます。パスワードは、管理コンソールのロックを解除するために使用するものと同じです（例: <your-circleci-hostname>.com:8800 ）。
replicated loginログインに成功したら、以下のコマンドを実行し、その出力を support@circleci.com までお送りください。何が原因で問題が発生しているのかを診断いたします。
sudo replicated appsrequest returned Unauthorized for API route というエラーが表示される場合、Replicated にログインしていないことが原因である可能性がありますので、ログイン成功後も同じエラーが発生するかどうかを確認してください。
4. Replicated のログをチェックする
Services マシンの Replicated ログデータは /var/log/replicated 配下にあります。
5. 現在実行している Docker コンテナを確認する
Replicated は、CircleCI Server v2.x を動作させるために多数の Docker コンテナを起動するので、実行中のコンテナを確認するのに便利です。
実行中のコンテナを確認するには、 sudo docker ps を実行します。すると、以下のような出力が表示されます。
$ sudo docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
eb2970306859 172.31.72.162:9874/circleci-api-service:0.1.6910-8b54ef9 "circleci-service-run" 26 hours
ago Up 26 hours 0.0.0.0:32872->80/tcp, 0.0.0.0:32871->443/tcp, 0.0.0.0:8082->3000/tcp,
0.0.0.0:32870->6010/tcp, 0.0.0.0:32869->8585/tcp api-service
01d26714f5f5 172.31.72.162:9874/circleci-workflows-conductor:0.1.38931-1a904bc8 "/service/docker-ent…" 26 hours
ago Up 26 hours 0.0.0.0:9998->9998/tcp, 0.0.0.0:32868->80/tcp, 0.0.0.0:32867->443/tcp,
0.0.0.0:9999->3000/tcp, 0.0.0.0:32866->8585/tcp workflows-conductor
0cc6e4248cfb 172.31.72.162:9874/circleci-permissions-service:0.1.1195-b617002 "/service/docker-ent…" 26 hours
ago Up 26 hours 0.0.0.0:3013->3000/tcp
permissions-service
9e6efc98b7d6 172.31.72.162:9874/circleci-cron-service:0.1.680-1fcd8d2 "circleci-service-run" 26 hours
ago Up 26 hours 0.0.0.0:4261->4261/tcp cron-service
8c40bd1cecf6 172.31.72.162:9874/circleci-federations-service:0.1.1134-72edcbc "/service/docker-ent…" 26 hours
ago Up 26 hours 0.0.0.0:3145->3145/tcp, 0.0.0.0:8010->8010/tcp, 0.0.0.0:8090->8090/tcp federations-service
71c71941684f 172.31.72.162:9874/circleci-contexts-service:0.1.6073-5275cd5 "./docker-entrypoint…" 26 hours
ago Up 26 hours 0.0.0.0:2718->2718/tcp, 0.0.0.0:3011->3011/tcp, 0.0.0.0:8091->8091/tcp contexts-service
71ffeb230a90 172.31.72.162:9874/circleci-domain-service:0.1.4040-eb63b67 "/service/docker-ent…" 26 hours
ago Up 26 hours 0.0.0.0:3014->3000/tcp domain-service
eb22d3c10dd8 172.31.72.162:9874/circleci-audit-log-service:0.1.587-fa47042 "circleci-service-run" 26 hours
ago Up 26 hours audit-log-service
243d9082e35c 172.31.72.162:9874/circleci-frontend:0.1.203321-501fada "/docker-entrypoint.…" 26 hours
ago Up 26 hours 0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp, 0.0.0.0:4434->4434/tcp frontend
af34ca3346a7 172.31.72.162:9874/circleci-picard-dispatcher:0.1.10401-aa50e85 "circleci-service-run" 26 hours
ago Up 26 hours picard-dispatcher
fb0ee1b02d48 172.31.72.162:9874/circleci-vm-service:0.1.1370-ad05648 "vm-service-service-…" 26 hours ago Up 26 hours 0.0.0.0:3001->3000/tcp vm-service
3708dc80c63e 172.31.72.162:9874/circleci-vm-scaler:0.1.1370-ad05648 "/scaler-entrypoint.…" 26 hours
ago Up 26 hours 0.0.0.0:32865->5432/tcp vm-scaler
77bc9d0b4ac9 172.31.72.162:9874/circleci-vm-gc:0.1.1370-ad05648 "docker-entrypoint.s…" 26 hours
ago Up 26 hours 0.0.0.0:32864->5432/tcp vm-gc
4b02f202a05d 172.31.72.162:9874/circleci-output-processing:0.1.10386-741e1d1 "output-processor-se…" 26 hours
ago Up 26 hours 0.0.0.0:8585->8585/tcp, 0.0.0.0:32863->80/tcp, 0.0.0.0:32862->443/tcp picard-output-processor
b8f982d32989 172.31.72.162:9874/circleci-frontend:0.1.203321-501fada "/docker-entrypoint.…" 26 hours ago Up 26 hours 0.0.0.0:32861->80/tcp, 0.0.0.0:32860->443/tcp, 0.0.0.0:32859->4434/tcp dispatcher
601c363a0c38 172.31.72.162:9874/circleci-frontend:0.1.203321-501fada "/docker-entrypoint.…" 26 hours
ago Up 26 hours 0.0.0.0:32858->80/tcp, 0.0.0.0:32857->443/tcp, 0.0.0.0:32856->4434/tcp legacy-notifier
f2190c5f3aa9 172.31.72.162:9874/mongo:3.6.6-jessie "/entrypoint.sh" 26 hours
ago Up 26 hours 0.0.0.0:27017->27017/tcp mongo
3cbbd959f42e 172.31.72.162:9874/telegraf:1.6.4 "/telegraf-entrypoin…" 26 hours
ago Up 26 hours 0.0.0.0:8125->8125/udp, 0.0.0.0:32771->8092/udp, 0.0.0.0:32855->8094/tcp telegraf
15b090e8cc02 172.31.72.162:9874/circleci-schedulerer:0.1.10388-741e1d1 "circleci-service-run" 26 hours
ago Up 26 hours picard-scheduler
fb967bd3bca0 172.31.72.162:9874/circleci-server-nomad:0.5.6-5.1 "/nomad-entrypoint.sh" 26 hours
ago Up 26 hours 0.0.0.0:4646-4648->4646-4648/tcp nomad
7e0743ee2bfc 172.31.72.162:9874/circleci-test-results:0.1.1136-b4d94f6 "circleci-service-run" 26 hours
ago Up 26 hours 0.0.0.0:2719->2719/tcp, 0.0.0.0:3012->3012/tcp test-results
0a95802c87dc 172.31.72.162:9874/circleci-slanger:0.4.117-42f7e6c "/docker-entrypoint.…" 26 hours
ago Up 26 hours 0.0.0.0:4567->4567/tcp, 0.0.0.0:8081->8080/tcp slanger
ca445870a057 172.31.72.162:9874/circleci-postgres-script-enhance:0.1.9-38edabf "docker-entrypoint.s…" 26 hours
ago Up 26 hours 0.0.0.0:5432->5432/tcp postgres
a563a228a93a 172.31.72.162:9874/circleci-server-ready-agent:0.1.105-0193c73 "/server-ready-agent" 26 hours
ago Up 26 hours 0.0.0.0:8099->8000/tcp ready-agent
d6f9aaae5cf2 172.31.72.162:9874/circleci-server-usage-stats:0.1.122-70f28aa "bash -c /src/entryp…" " 26 hours
ago Up 26 hours usage-stats
086a53d9a1a5 registry.replicated.com/library/statsd-graphite:0.3.7 "/usr/bin/supervisor… 26 hours
ago Up 26 hours 0.0.0.0:32851->2443/tcp, 0.0.0.0:32770->8125/udp replicated-statsd
cc5e062844be 172.31.72.162:9874/circleci-shutdown-hook-poller:0.1.32-9c553b4 "/usr/local/bin/pyth…" " 26 hours
ago Up 26 hours musing_volhard
9609f04c2203 172.31.72.162:9874/circleci-rabbitmq-delayed:3.6.6-management-12 "docker-entrypoint.s… 26 hours
ago Up 26 hours 0.0.0.0:5672->5672/tcp, 0.0.0.0:15672->15672/tcp, 0.0.0.0:32850->4369/tcp, 0.0.0.0:32849->5671/tcp, 0.0.0.0:32848->15671/tcp, 0.0.0.0:32847->25672/tcp rabbitmq
2bc0cfe43639 172.31.72.162:9874/tutum-logrotate:latest "crond -f" 26 hours
ago Up 26 hours hardcore_cray
79aa857e23b4 172.31.72.162:9874/circleci-vault-cci:0.3.8-e2823f6 "./docker-entrypoint…" 26 hours
ago Up 26 hours 0.0.0.0:8200-8201->8200-8201/tcp vault-cci
b3e317c9d62f 172.31.72.162:9874/redis:4.0.10 "docker-entrypoint.s…" 26 hours
ago Up 26 hours 0.0.0.0:6379->6379/tcp redis
f2d3f77891f0 172.31.72.162:9874/circleci-nomad-metrics:0.1.90-1448fa7 "/usr/local/bin/dock…" " 26 hours
ago Up 26 hours nomad-metrics
1947a7038f24 172.31.72.162:9874/redis:4.0.10 "docker-entrypoint.s… 26 hours
ago Up 26 hours 0.0.0.0:32846->6379/tcp slanger-redis
3899237a5782 172.31.72.162:9874/circleci-exim:0.2.54-697cd08 "/docker-entrypoint.…" 26 hours
ago Up 26 hours 0.0.0.0:2525->25/tcp exim
97ebdb831a7e registry.replicated.com/library/retraced:1.2.2 "/src/replicated-aud…" " 26 hours
ago Up 26 hours 3000/tcp retraced-processor
a0b806f3fad2 registry.replicated.com/library/retraced:1.2.2 "/src/replicated-aud… 26 hours
ago Up 26 hours 172.17.0.1:32771->3000/tcp retraced-api
19dec5045f6e registry.replicated.com/library/retraced:1.2.2 "/bin/sh -c '/usr/lo…" " 26 hours
ago Up 26 hours 3000/tcp retraced-cron
7b83a3a193da registry.replicated.com/library/retraced-postgres:10.5-20181009 "docker-entrypoint.s… " 26 hours
ago Up 26 hours 5432/tcp retraced-postgres
029e8f454890 registry.replicated.com/library/retraced-nsq:v1.0.0-compat-20180619 "/bin/sh -c nsqd" 26 hours
ago Up 26 hours 4150-4151/tcp, 4160-4161/tcp, 4170-4171/tcp retraced-nsqd
500619f53e80 quay.io/replicated/replicated-operator:current "/usr/bin/replicated… 26 hours
ago Up 26 hours replicated-operator
e1c752b4bd6c quay.io/replicated/replicated:current "entrypoint.sh -d" 26 hours
ago Up 26 hours 0.0.0.0:9874-9879->9874-9879/tcp replicated
1668846c1c7a quay.io/replicated/replicated-ui:current "/usr/bin/replicated…" 26 hours
ago Up 26 hours 0.0.0.0:8800->8800/tcp replicated-ui
f958cf3e8762 registry.replicated.com/library/premkit:1.2.0 "/usr/bin/premkit da…" 3 weeks
ago Up 26 hours 80/tcp, 443/tcp, 2080/tcp, 0.0.0.0:9880->2443/tcp replicated-premkitサービスマシンからの sudo docker ps の出力を support@circleci.com にお送りください。問題の原因を診断いたします。
ドキュメントの改善にご協力ください
このガイドは、CircleCI の他のドキュメントと同様にオープンソースであり、 GitHub でご利用いただけます。 ご協力いただき、ありがとうございます。
- このページの編集をご提案ください (最初に「コントリビューションガイド」をご覧ください)。
- ドキュメントの問題点を報告する、またはフィードバックやコメントを送信するには、GitHub で issue を作成してください。
- CircleCI は、ユーザーの皆様の弊社プラットフォームにおけるエクスペリエンスを向上させる方法を常に模索しています。 フィードバックをお寄せいただける場合は、リサーチコミュニティにご参加ください。
サポートが必要ですか
CircleCI のサポートエンジニアによる、サービスに関する問題、請求およびアカウントについての質問への対応、設定の構築に関する問題解決のサポートを行っています。 サポートチケットを送信して、CircleCI のサポートエンジニアにお問い合わせください。日本語でお問い合わせいただけます。
または、 サポートサイト から、サポート記事やコミュニティフォーラム、トレーニングリソースをご覧いただけます。
CircleCI Documentation by CircleCI is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.