Jira アプリケーションを Azure SQL に接続する
Jira アプリケーションのデータベースへの接続
このページの内容
関連コンテンツ
- 関連コンテンツがありません
ここでは、Jira Server または Jira Data Center を Azure SQLデータベースに接続する手順について説明します。
はじめる前に
- Jira アプリケーションを別のサーバに移行する場合は、データのエクスポートを XML バックアップとして作成します。その後、「データベースの切替」の説明に従い、元のデータベースから新しいデータベースへデータを移行できます。
- Azure に精通していない場合、アトラシアンの公式テンプレートを使用して Jira Data Center を Azure に簡単にデプロイできます。
1. Azure SQL データベースを作成する
Azure SQL データベースを作成します。「クイックスタート: Azure で単一のデータベースを作成する」を参照してください。
要件
- 照合順序: データベースを作成するときは、[追加設定] で適切な照合順序を設定するようにします。あとから変更することはできません。Jira でサポートされる照合タイプは
SQL_Latin1_General_CP437_CI_AI
とLatin1_General_CI_AI
です。
2. Jira にデータベースへの接続を許可する
Jira が Azure SQL データベースに接続できるようにするには、Jira サーバーの IP アドレスをデータベースのファイアウォール ルールに追加する必要があります。Azure SQL データベースのファイアウォール ルールを参照してください。
3. Jira を構成してデータベースに接続する
Jira サーバーを Azure SQL データベースに接続するには、2 つの方法があります。
接続文字列を見つける
Jira をデータベースに接続するときは、ホスト名、ポート番号、データベース名などの接続の詳細を指定する必要があります。これらは、Azure ポータルでデプロイされたデータベースを開き、[Connection strings] に移動することで見つけることができます。
Jira セットアップ ウィザード を使用する — Jira をインストールした直後で Jira を初めてセットアップする場合はこの方法を使用します。設定は、Jira アプリケーションのホーム ディレクトリの
dbconfig.xml
ファイルに保存されます。手順についてブラウザから初めて Jira にアクセスすると、Jira セットアップ ウィザード が表示されます。
- 最初の画面 の “Configure Language and Database” で、 “Database Connection” に My own database を選択します。
- [Database Type] を [Microsoft SQL Server] に設定します。
- 下記の データベース接続関連フィールド を参照し、フィールド入力を行います。
- 接続をテストし、保存します。
Jira 設定ツールを使用する — 既存の Jira インスタンスがある場合はこの方法を使用します。設定は、Jira アプリケーションのホーム ディレクトリの
dbconfig.xml
ファイルに保存されます。手順について- 次のように Jira 設定ツールを実行します。
- Windows: コマンド プロンプトを開いて、Jira インストール ディレクトリの
bin
サブディレクトリにあるconfig.bat
を実行します。 - Linux/Unit: コンソールを開いて、Jira インストール ディレクトリの
bin
サブディレクトリにあるconfig.sh
を実行します。
- Windows: コマンド プロンプトを開いて、Jira インストール ディレクトリの
- [Database] タブに進み、[Database type] を [Microsoft SQL Server] に設定します。
- 下記の データベース接続関連フィールド を参照し、フィールド入力を行います。
- 接続をテストし、保存します。
- Jira を再起動します。
- 次のように Jira 設定ツールを実行します。
データベース接続フィールド
以下のセクションは、Jira をデータベースに接続するときに入力する必要があるフィールドを示しています。
フィールド | 説明 / 例 |
---|---|
ホスト名 | Azure SQL サーバーの名前または IP アドレス。 例: |
ポート | Azure SQL サーバーがリッスンしている TCP/IP ポート。このフィールドが空の場合、デフォルト ポートが使用されます。 既定: |
データベース | Azure SQL データベースの名前 (Jira のデータ保存先)。 例: |
ユーザ名 | Jira が SQL Server のサーバー接続時に使用するユーザー。 例: |
パスワード | Azure SQL サーバーとの認証に利用するユーザーのパスワード。 |
スキーマ | Azure SQL データベースが使用するスキーマ名。 既定: |
フィールド | 説明 / 例 |
---|---|
ホスト名 | Azure SQL サーバーの名前または IP アドレス。 -
|
ポート | Azure SQL サーバーがリッスンしている TCP/IP ポート。このフィールドが空の場合、デフォルト ポートが使用されます。 -
|
データベース | Azure SQL データベースの名前 (Jira のデータ保存先)。 -
|
ユーザ名 | Jira が SQL Server のサーバー接続時に使用するユーザー。 -
|
パスワード | Azure SQL サーバーとの認証に利用するユーザーのパスワード。 -
|
スキーマ | Azure SQL データベースが使用するスキーマ名。 -
|
dbconfig.xml ファイルのサンプル
上記の dbconfig.xml
ファイルに含まれる、pool
で始まる <jdbc-datasource/>
の子要素の詳細については、「データベース接続のチューニング」を参照してください。
<jira-database-config>
<name>defaultDS</name>
<delegator-name>default</delegator-name>
<database-type>mssql</database-type>
<schema-name>dbo</schema-name>
<jdbc-datasource>
<url>jdbc:sqlserver://;serverName=sqlserver.database.windows.net;portNumber=1433;databaseName=jiradb</url>
<driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver</driver-class>
<username>adminsql@sqlserver</username>
<password>T3ddybear</password>
<pool-min-size>20</pool-min-size>
<pool-max-size>20</pool-max-size>
<pool-max-wait>30000</pool-max-wait>
<validation-query>select 1</validation-query>
<min-evictable-idle-time-millis>60000</min-evictable-idle-time-millis>
<time-between-eviction-runs-millis>300000</time-between-eviction-runs-millis>
<pool-max-idle>20</pool-max-idle>
<pool-remove-abandoned>true</pool-remove-abandoned>
<pool-remove-abandoned-timeout>300</pool-remove-abandoned-timeout>
<pool-test-on-borrow>false</pool-test-on-borrow>
<pool-test-while-idle>true</pool-test-while-idle>
</jdbc-datasource>
</jira-database-config>
関連コンテンツ
- 関連コンテンツがありません