Azure で Confluence Data Center の使用を開始する

このページの内容:

Confluence Data Center は Microsfot Azure 環境に最適です。Microsoft Azure で Confluence Data Center をデプロイできる参照用テンプレートを提供します。ユーザーは Azure のベスト プラクティスに応じてそのテンプレートを設定できます。Azure で Confluence Data Center を稼働するのに必要なものをすべて取得する最も早い方法です。 

独自のハードウェアで Confluence Dta Center インストールを行う場合と同じ用に、ユーザー管理、中央ログ作成ストレージ、バックアップ戦略および監視を設定することを強くお勧めします。

動作の仕組み

テンプレートを使用して Confluence Data Center をデプロイする際のアーキテクチャの概要は次のとおりです。

デプロイメントは、以下のコンポーネントで構成されています。

  • スケール セット内で、Confluence を実行する、クラスター ノードとしての 1 つ以上の Azure 標準 Linux VM インスタンス
  • Azure SQL Server or PostgreSQL database
  • a storage account for the shared home directory which contains attachments and other files accessible to all Confluence nodes (local redundant storage)
  • an application gateway (multiple instances for high availability) 
  • a small Azure Linux VM to use as a bastion host (to access cluster nodes via SSH). 

The Azure SQL database is private and only accessible via a database service endpoint from the Confluence application nodes.

The application gateway acts as load balancer for your scale set of Confluence nodes and web application firewall.

We use a storage account for Confluence's shared home directory. It's mounted on each Confluence node, and treated as any other file store would be.

Synchrony will be managed by Confluence (on Confluence nodes). This means you don't need to provision or configure anything to be able to enable collaborative editing. 

制限事項

Azure へのデプロイについて、次の制限事項をご確認ください。

  • Confluence がノードの検出に使用している Hazelcast の問題により、現在オートスケーリングをご利用いただけません。 
  • You can't use the deployment template to upgrade an existing Confluence deployment, or to provision new nodes running a different version to the rest of your cluster. 
  • ノードが手動で削除された場合、クラスターを削除しない限り再デプロイすることはできません。再デプロイを行っても、既存のデータベースと既存のホーム ディレクトリは削除されません。

Preparing for your deployment

Before you begin, you should use the Confluence Data Center load profiles to determine the size of your site.  This information will help you choose the right infrastructure size during deployment.

You should also decide which Azure region is best for your site. Some services, such as such as Application Insights and Azure SQL Analytics, may not be available in all regions. You can check this at https://azure.microsoft.com/en-gb/global-infrastructure/regions/

During the deployment you'll need:

  • Your database details, if you want to use an existing Azure database service. You'll need the database URL, port, username, and password. 
  • A Base64 encoded PFX certificate from a trusted Certificate Authority.
  • Details of your existing CNAME, if you don't want Azure to generate a random domain for you. 

Migrating an existing site to Azure

To migrate, you will need to set up a new Confluence Data Center site in Azure, and then import content from your old site. This approach ensures that your new site is created with optimum settings for Azure. 

Here's a high level overview of the steps:

  1. Back up your existing site, including your database and home directories. 
  2. Make a list of any Marketplace or other user-installed apps
  3. Perform a full site export, excluding attachments if you have a large site. You can also turn on read-only mode, to prevent users from making changes in your old site. 
  4. Deploy Confluence Data Center in Azure via the Azure Portal, or CLI, and test that Confluence is working as expected. 
  5. Import your site export file.  Make sure you know the administrator password for your existing site, as you'll be logged out during the import.
  6. Copy the contents of your /attachments directory to the equivalent directory in your shared home. 
  7. Install any apps.
  8. Test your site. 

At this point you can make the site available to your users, and tear down your old site. 

Tips for a successful migration:

  • Do a trial run first - export your existing site, and import it into Azure to iron out any issues. 
  • Because you're setting up your new site in parallel, your current Confluence site can remain accessible throughout the process.  If you're already running Confluence Data Center, use read-only mode to prevent people making changes after you've exported the site. 
  • Unless your existing site is small, exporting the site without attachments will keep the export file smaller. 

Azure マーケットプレイス経由で Confluence Data Center をデプロイする

この方法では、Azure Marketplace でデプロイメント テンプレートをリファレンスとして使用して Confluence Data Center をデプロイします。 

Marketplace アプリを使用して Azure に Confluence Data Center をデプロイするには、次の手順を実行します。

  1. Azure ポータルにログインします。
  2. Choose Create a resource to start a new deployment
  3. Atlassian を検索し、Marketplace アプリの一覧から Confluence Data Center を選択します。
  4. [作成] を選択してデプロイメントの設定を開始します。
  5. ウィザードの指示に従ってデプロイメントを設定します。詳細は、以下のパラメーター テーブルを参照してください。 
  6. すべての情報が正しいことを確認し、[作成] をクリックしてサブスクリプションを購入します。デプロイメントには約 30 分かかります。  
  7. Once deployment is complete, go to the Confluence URL (APPENDPOINT) listed in the deployment outputs to complete onboarding and start using Confluence.  

パラメータ

パラメータ 説明
サブスクリプション Microsoft Azure サブスクリプション タイプ。
リソース グループ 既存のリソース グループがある場合は、それを使用するか、新しく作成できます。
場所 Azure がデプロイメントを格納する領域です。
Confluence バージョン Specify the version of Confluence you'd like to install in full. For example 6.14.0. Head to Confluence Release Notes for a list of all releases.
Confluence admin credentials

インスタンスの最初の Confluence 管理者の名前とパスワードを提供します。

Confluence Cluster

Select the expected size of your site - trial, small, medium, large, extra large. This will determine the number of Confluence application nodes, and the size of VMs to be provisioned. Choose Change Size to override the defaults.

データベース タイプ Choose either a SQL Server or PostgreSQL database.
データベース資格情報

データベース管理者ユーザーのユーザー名とパスワードを提供します。

If you have an existing database in the same location and resource group, you can choose to use your existing database, and enter its details here.

SSH Access

Provide an SSH public key to be used to SSH into the instance that will act as bastion host, and a username and password for SSH access to the Confluence nodes.

See Create and use an SSH public-private key pair for Linux VMs in Azure in the Microsoft Azure documentation.

cname

This is the  Canonical Name record (CNAME) for your organization. If you don't provide one, Azure will generate a random sub domain for your instance.

HTTP/SSL Provide the certificate and password to be used for SSL termination on the Azure Application Gateway.
監視 Choose the monitoring and analytics services that you would like to enable. Subject to availability in your location.


CLI を使用して Confluence Data Center をデプロイする

この方法では、Azure コマンドライン インターフェースで、デプロイメント テンプレートを参考に使用して Confluence Data Center をデプロイします。これを行うには、Azure CLI をインストールする必要があります。

Using the deployment templates directly allows for greater configuration granularity. All hardware choices such as the number of cluster nodes, size, disk size, and OS type are configurable as parameters. 

Head to https://bitbucket.org/atlassian/atlassian-azure-deployment and check out the README to find out how to to deploy using the CLI. 

必須パラメーター 

Confluence Data Center インスタンスをデプロイするには、デプロイメント テンプレートで多数の値を提供する必要があります。 

パラメータ 説明

confClusterSize

To use recommended hardware options for the Confluence installation choose a size. Allowed values:

  • trial
  • 文字サイズ小
  • Medium
  • enterprise

If set, all further Gateway, VM, DB size parameters will be ignored.

clusterSshPassword

This is the SSH password you'll use to access your Confluence nodes.

dbPassword

専用データベース ユーザーのパスワードです。

パスワードはパスワード強度要件 (AzureSQL Server による制限) を満たす必要があり、16 ~ 41 文字で、大文字、小文字、数字 (0-9)、および英数字以外の文字 (、!、$、#、%、など) をそれぞれ 1 つ以上含める必要があります。詳細は、Azure SQL パスワード ドキュメントを参照してください。

confAdminUserPassword

Confluence 管理者アカウントのパスワードです。

オプション パラメーター 

The following parameters are optional. If you don't provide a value in the parameter file, we'll use the default values listed below. 

パラメータ 既定値 説明

confluenceVersion

最新版

This is the version of Confluence you want to install on your cluster nodes. Enter the Confluence version number in full, for example "6.14.0".

We don't recommend using versions prior to 6.12, as they don't support managed Synchrony.

customDownloadUrl

Use this URL to override standard Atlassian download url, for example to specify beta, release candidate or EAP versions. Used in conjunction with the confluenceVersion parameter.

dbCreateNew

true

Create a new database or attempt to use an existing specified database. Note that this has to be in same resource group and location as the target deployment.

dbType

Azure SQL DB Choose between Azure SQL Server and Azure DB for PostgreSQL.
dbHost auto-generated The hostname of database server to be used if an external database is being used. This will be autogenerated if a new database is to be created.
dbPort 1433 The database port to use if an external database is being used. This will be autogenerated if a new database is to be created.
dbDatabase confdatabase The database name to use if an external database is being used. This will be autogenerated if a new database is to be created.
dbSchema auto-generated The database schema to use if an external database is being used. This will be autogenerated if a new database is to be created.
dbUsername confluencedbuser The username for the dedicated database user.

cname

auto-generated

This is the Canonical Name record (CNAME) for your organization. If you don't provide one, Azure will generate a random domain.

If you do use a custom domain, you must also update your Domain Registrar's settings to add the Azure DNS Name Servers. Consult your domain registry's documentation on how to configure cname records.

sslBase64EncodedPfxCertificate


The certificate to be used for SSL termination on the Azure Application Gateway.

sslPfxCertificatePassword


The certificate password to be used for SSL termination on the Azure Application Gateway.

jumpboxSshKey

The SSH public key to use to access the bastion host (jumpbox)

confAdminUserName

管理 The username for the Confluence Administrator's account. Must be lowercase.

confAdminUserFullName

Admin Admin The full name of the Confluence Administrator's account.
confAdminUserEmail admin@example.com The email address of the Confluence Administrator user.
confAppTitle Atlassian Confluence The name of your Confluence site.
jumpboxSshUser confluenceadmin This is the SSH user you'll use to access the bastion host (jumpbox).
clusterSshUser confluenceadmin The SSH username to use to access the Confluence nodes from the bastion host (jumpbox). This is the only way you can access Confluence nodes.
enableEmailAlerts true Enable email alerts.
enableApplicationInsights true Enable Azure Application Insights.

enableAnalytics

true Enable Azure Operational Insights.

Overriding the recommended hardware options

The confClusterSize parameter allows you to select the size of your deployment, and then use our recommendations for all resources to be created. 

If you choose not to set the confClusterSize parameter, you can choose to define your own values for things like dbTier, dbTierSize, clusterVmSize, LinuxOsType, and appGtwyTier

These parameters are all listed in the azuredeploy.json template file, with a description and allowed values.  You should also check out the Developing guide in the template repository to learn more about developing your own template.   

Securing your Azure deployment

We recommend deploying Confluence with SSL. Our template will prompt you for a certificate and password. 

参考情報

  • HTTPS is terminated at the application gateway.
  • Your certificate should be from a trusted Certificate Authority. You should avoid self-signed certificates.

監視

As a number of the resources we provision are managed by Azure, a number of options are available for  monitoring. For example:

  • A number of default alerts are available, such as cluster nodes going offline, CPU, or Db DTU exceeding 80%. These alerts will be emailed to the Confluence Administrator email address specified in the deployment.

  • Application Insights can be used to see the overall system health, and dig into particular areas of interest Application Insights in the Azure documentation. 

  • Azure SQL Analytics is available for more granular monitoring of your SQL Server database.   Monitor Azure SQL Database using Azure SQL Analytics in the Microsoft Azure documentation. 

Note that some of these resources are still in Preview, so may not be available in your location yet. 

最終更新日 2019 年 4 月 11 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する

このセクションの項目

Powered by Confluence and Scroll Viewport.