サーバーのインストールを構成する

サーバーポートの変更

別のアプリケーションが TeamCity サーバーと同じポートを使用している場合、サーバーは起動できません。その結果、サーバーログまたはサーバーコンソールに「すでに使用されている住所」エラーが表示されます。

.exe からサーバーをインストールする場合は、インストールウィザードでポートをカスタマイズできます。

インストール / 解凍されたサーバーのポートを変更するには、 <TeamCity Home Directory> /conf/server.xml ファイルを開き、コメントされていない <Connector> XML ノードに別の番号を設定します。

変更を適用するには、でサーバーを再起動します。

稼働中の TeamCity サーバーのポートを変更する場合は、サーバーに保存されているすべての URL (ブラウザーのブックマーク、エージェントの serverUrl プロパティ、ユーザーの IDE の URL、管理 | グローバル設定ページのサーバー URL 設定) でもポートを変更する必要があります。
同じマシン上で別の Tomcat サーバーを実行する場合は、Tomcat サーバーの他のサービスポートも変更する必要がある可能性があります (server.xml ファイルで port= を検索してください)。

HTTPS プロトコルを使用する場合は、別途有効にする必要があります。プロセスは、使用する Web サーバー (デフォルトでは Tomcat) に固有です。TeamCity Web UI の HTTPS を構成する方法については、注記を参照してください。

サーバーコンテキストの変更

デフォルトでは、TeamCity サーバーはサーバーアドレスのルートコンテキスト（ http://localhost:8111/ など）でアクセス可能です。代わりにネストしたパス（たとえば http://localhost:8111/teamcity/ ）で利用できるようにするには、次の手順を実行する必要があります。

1. TeamCity サーバーを停止します。

2. <TeamCity Home Directory> \webapps\ROOT ディレクトリの名前を <TeamCity Home Directory> \webapps\teamcity に変更します。

3. TeamCity サーバーを起動します。

TeamCity サーバーのメモリ設定を構成する

TeamCity サーバーには、子プロセスを起動することもできるメインプロセスがあります。子プロセスは、マシンで使用可能なメモリを使用します。このセクションでは、特別な構成が必要なため、メインの TeamCity サーバープロセスのメモリ設定についてのみ説明します。

JVM アプリケーションとして、TeamCity メインサーバープロセスは JVM で使用可能なメモリのみを使用します。必要なメモリは JVM ビット数 (64- または 32 ビット) によって異なります。JVM が使用するメモリは通常、ヒープ (-Xmx で構成) とメタスペース (使用可能なネイティブメモリの量によって制限されます)、内部 JVM (通常は数十 MB)、およびメモリマップファイルなどの OS 依存のメモリ機能で構成されます。TeamCity は主にヒープメモリに依存します。ヒープメモリサイズを構成するには、次の手順を実行します。

TEAMCITY_SERVER_MEM_OPTS 変数の可能な値:

• 最小設定 : 64 ビット Java の場合は -Xmx1024m (バンドル)、32 ビット Java の場合は -Xmx750m

• 中規模サーバーの推奨設定 : 64 ビット Java の場合は -Xmx2048m、32 ビット Java の場合は -Xmx1024m32 ビット Java で設定値を大きくすると、OutOfMemoryError が発生し、「ネイティブメモリ割り当て (malloc) に失敗しました」JVM がクラッシュしたり、「新しいネイティブスレッドを作成できません」というメッセージが表示されることがあります。

• 大規模サーバー向けの推奨設定 (64 ビット Java を使用する必要があります): -Xmx4g この設定は、最大 200 のエージェントと数千のビルド構成を含むインストールに適しています。カスタムプラグインでは、Xmx パラメーターで定義された値を増やす必要がある場合があります。

• 大規模サーバーの最大設定（64 ビット Java を使用する必要があります）: -Xmx10g 大規模な TeamCity のインストールには、より大きな値を使用できます。ただし、通常、TeamCity サポートに相談せずに 10g より大きい値を使用することはお勧めしません。

新しいサーバーのインストールでは、ReservedCodeCacheSize=640m 属性がデフォルトで設定されます。属性が TeamCity 2022.04.4 より前に指定されていた場合は、アップグレード後に手動で更新する必要があります。

OutOfMemory エラーが発生するか、TeamCity UI にメモリ関連の警告が常に表示される場合は、設定を次のレベルに上げる必要があることを意味します。

TeamCity データディレクトリを構成する

TeamCity データディレクトリのデフォルトの配置は変更できます。詳細については、この記事を参照してください。

本番用のサーバーの設定

すぐに使用できる TeamCity サーバーのインストールは、評価目的に適しています。本番環境で使用する場合は、追加の構成を実行する必要があります。通常、次の手順が含まれます。

• サーバーが適切なサーバーポートを使用していることを確認し、HTTPS 経由でアクセスを構成します。

• TeamCity サーバーの URL とメールサーバーの設定が正しいことを確認してください。

• マシンの再起動時に OS に依存する自動起動のためにサーバープロセスを構成します。

• TeamCity データディレクトリには信頼性の高いストレージを使用してください。

• 外部データベースを使用します。

• 推奨メモリ設定を構成します。アクティブなサーバーまたは成長中のサーバーには「最大設定」を使用してください。

• 定期的なバックアップを計画します。

• 最新の TeamCity リリースへの定期的なアップグレードを計画します。

• <TeamCity Data Directory> \conf\teamcity-startup.properties ファイルに teamcity.installation.completed=true 行を追加することを検討してください。これにより、管理者ユーザーが見つからない場合にサーバーが管理者ユーザーを作成しなくなります。

• パフォーマンスとセキュリティに関する注意事項について、サーバーの構成に関する注意事項を必ず参照してください。