組織サイトの作成

ArcGIS Enterprise on Kubernetes を Kubernetes クラスターにデプロイした後、ArcGIS Enterprise 組織サイトを作成する必要があります。 組織サイトは次の 2 つの方法のいずれかで作成できます。

• ブラウザーを使用してセットアップ ウィザードを実行します。

• configure.sh スクリプトを使用して、サイレントに組織サイトを作成します。

構成スクリプトは、.tar.gz ファイルとして配布されるデプロイメント パッケージに付属しています。このパッケージは、My Esri からダウンロードできます。

いずれのオプションも、以下の操作を行います:

• ArcGIS Enterprise on Kubernetes 用 Esri Docker イメージのダウンロード

• ArcGIS Enterprise on Kubernetes クラスターへの ArcGIS Enterprise on Kubernetes コンテナーのデプロイ

• ArcGIS Enterprise 組織の作成

セットアップ ウィザードの使用

ArcGIS Enterprise on Kubernetes をデプロイしたら、構成ウィザードで以下のステップを実行して、組織サイトを完成させます:

Web ブラウザーで 新しい組織の作成 リンクを開きます。 ロード バランサーの URL を参照し、URL の末尾に /manager を追加します。 たとえば、ロード バランサーのコンテキストが arcgis の場合は、https://organization.example.com/arcgis/manager URL を開きます。

ページが、ArcGIS Enterprise on Kubernetes セットアップ ウィザードにリダイレクトされます。 続行 をクリックして開始します。 ウィザードを完了するには、次の手順に従います。

1. アーキテクチャー プロファイル ページの 可用性 タブで、組織の冗長性の要件を満たす可用性プロファイルを選択し、次へ をクリックします。

2. パフォーマンス タブで、組織のスループットと遅延の要件を満たすパフォーマンス プロファイルを選択し、次へ をクリックします。

3. ライセンスの配布 ページで、ArcGIS Enterprise on Kubernetes ライセンス ファイルをアップロードして、プライマリー管理者アカウントのユーザー タイプを指定します:

   1. ライセンス ファイル (.json ファイル) を選択します。これにより、組織のユーザー タイプとアプリがライセンス認証されます。 このファイルは My Esri から取得できます。

   2. 次のステップで作成するプライマリー管理者のアカウントのユーザー タイプを選択します。

      組織サイトの作成後、管理者のユーザー タイプを変更できます。

   3. 次へ をクリックします。

4. 管理者アカウントの作成 ページで、ArcGIS Enterprise 組織サイトのプライマリー管理者アカウントを作成します。 ユーザー名、パスワード、メール アドレス、氏名、およびセキュリティーの質問と答えを入力し、次へ をクリックします。

   ユーザー名は 6 文字以上にする必要があります。 使用できる特殊文字は、単価記号 (@)、ダッシュ (-)、ピリオド (.)、アンダースコア (_) のみです。

   パスワードは 8 文字以上にする必要があります。 パスワードには 1 文字以上のアルファベット (大文字または小文字) と、1 文字以上の数字が含まれている必要があります。 特殊文字はすべて使用できます。

5. ストレージ情報の設定 ページで、システム管理ストレージを使用している各ストレージ アイテムについて以下の情報を入力します:

   1. ボリュームの種類 で、動的 または 静的 を選択して、永続ボリューム (PV) のプロビジョニング方法を指定します。

      PVC が既存の PV にバインドする必要がある場合は 静的 を使用します。 指定したストレージ クラスを使用して新しい PV をプロビジョニングする必要がある場合は、動的 を使用します。

   2. ストレージ クラス名 で、独自のストレージ クラス名を指定するか、またはストレージ クラスを設定した場合は、各ボリュームのストレージ クラス名を指定します。

      注意:

      ストレージ クラスが定義されていない既存の PV にバインドする場合は、ストレージ クラス名を空白のままにします。 クラスターにデフォルトのストレージ クラスが構成されている場合、DefaultStorageClass アドミッション コントローラーによってデフォルトのストレージ クラスが追加され、PVC がバインドされないようにします。 この場合、管理者は PV にストレージ クラスの指定を追加するか、デフォルトのストレージ クラスの構成を削除する必要があります。

   3. サイズ (GiB) で、PV のサイズを定義します。

      推奨サイズは、選択した可用性プロファイルによって異なります。 静的 PV をプロビジョニングする場合は、この値が既存の PV のサイズと一致する必要があります。 最小サイズ要件が満たされていることを確認します。

   4. ラベル セレクター で、ラベルを選択します。

      これは、静的プロビジョニングで必須です。 ラベルは既存の PV のラベルと一致する必要があります。 ラベル例については、「静的プロビジョニング」をご参照ください。

   5. システム管理のデータ ストアがスケジュールされているノードを制御する必要がある場合は、ポッドの配置の管理 (オプション) を展開して ルールの管理 をクリックしてノード アフィニティーを構成するか、耐障害性の管理 をクリックして容認を構成します。

      このステージでポッドの配置ポリシーを適用することをおすすめします。これにより、ポッドの配置ポリシーを後から適用した場合に、アクティブな組織を読み取り専用モードにする必要性をなくすことができます。 ポッドの配置の詳細については、「ポッドの配置」をご参照ください。

6. クラウド オブジェクト ストアを使用している場合は、ドロップダウン メニューからストレージ サービスを選択し、そのサービスで必要な情報を入力します。

   1. Amazon S3 を使用するなら、次の情報を入力します。

      • バケット名 - Amazon S3 で作成されたバケットの名前。

      • リージョン - バケットが存在するリージョン。

        注意:

        プライベート S3 エンドポイントに接続するには、リージョンとして カスタム を選択します。 プライベート URL フィールドに、プライベート クラウドにアクセスするための URL を入力するか貼り付けます。

      • フォルダー (オプション) - オブジェクト ストアに使用できる Amazon S3 内の既存の、または存在しないルート ディレクトリーの名前。 ルート ディレクトリーには、既存の組織が作成または使用するファイルを含めることはできません。 値が指定されていない場合は、デフォルトの arcgis が使用されます。 バケット内に arcgis という名前のルート ディレクトリーがすでに存在する場合は、新たに一意のルート ディレクトリー名を指定する必要があります。

      • 認証タイプ - アクセス キー または IAM ロール。

      認証タイプとしてアクセス キーを使用するなら、次の情報を入力します。

      • アクセス キー - IAM ユーザーのアクセス キー。

      • シークレット キー - IAM ユーザーのシークレット キー。

   2. Azure Blob を使用するなら、次の情報を入力します。

      • コンテナー名 - Azure で作成されたコンテナーの名前。

      • フォルダー (オプション) - オブジェクト ストアに使用できる Azure Blob 内の既存の、または存在しないルート ディレクトリーの名前。 ルート ディレクトリーには、既存の組織が作成または使用するファイルを含めることはできません。 値が指定されていない場合は、デフォルトの arcgis が使用されます。 バケット内に arcgis という名前のルート ディレクトリーがすでに存在する場合は、新たに一意のルート ディレクトリー名を指定する必要があります。

      • ストレージ アカウント - コンテナーの上位に位置する親ストレージ アカウントの名前。

      • ストレージ ドメイン - Blob ストレージ コンテナーが配置された Azure ストレージ ドメイン。

        注意:

        カスタム Azure Blob エンドポイントに接続するには、ストレージ ドメインとして その他 を選択し、URL または DNS エンドポイントを指定して、ストレージの場所にアクセスします。

      • 認証タイプ - ストレージ アカウント キー または マネージド ID。

      • 認証タイプとして ストレージ アカウント キー を使用するなら、以下を入力します。

        • ストレージ アカウント - コンテナーの上位に位置する親ストレージ アカウントの名前

        • アカウント キー - 関連付けられているストレージ アカウントのプライマリー アカウント キーまたはセカンダリー アカウント キー

        認証タイプとして マネージド ID を使用している場合、ID タイプとして システム割り当て または ユーザー割り当て を選択します。 ユーザー割り当て ID を選択した場合は、クライアント ID を指定します。

        注意:

        ユーザー割り当て ID は、ホスティングおよびフェデレーション ArcGIS Server サイトが実行中のインスタンスに割り当てられており、少なくともストレージ アカウント コンテナーへの読み取り専用アクセス権を持つ必要があります。 複数のユーザー割り当てマネージド ID がインスタンスまたはストレージ コンテナーに割り当てられている場合は、クライアント ID を指定する必要があります。

   3. Google Cloud Storage を使用するなら、次の情報を入力します。

      • バケット名 - Google Cloud Storage で作成されたバケットの名前。

      • フォルダー (オプション) - オブジェクト ストアに使用できる Google クラウド ストレージ内の既存の、または存在しないルート ディレクトリーの名前。 ルート ディレクトリーには、既存の組織が作成または使用するファイルを含めることはできません。 値が指定されていない場合は、デフォルトの arcgis が使用されます。 バケット内に arcgis という名前のルート ディレクトリーがすでに存在する場合は、新たに一意のルート ディレクトリー名を指定する必要があります。

      • アクセス キー - サービス アカウントのアクセス キー

      • シークレット キー - サービス アカウントのシークレット キー

      注意:

      マルチリージョンのバケットはストレージの可用性と冗長性を向上させますが、バックアップの作成時または復元時にパフォーマンスの低下や予期しない遅延を招く可能性があります。 リージョナル、デュアルリージョン、マルチリージョンのクラウド ストレージ間の違いと場所に関する考慮事項については、Google Cloud のドキュメントをご参照ください。

7. クラウド リレーショナル ストアを使用している場合は、ドロップダウン メニューからデータベース サービスを選択し、次の情報を入力します。 このオプションの要件を満たしていることを確認するには、「クラウド リレーショナル ストアの使用に関する注意事項」をご参照ください。

   • データベース エンドポイント - 読み取りと書き込みの両操作を許可するデータベース エンドポイント。 これは通常、すべてのデータ変更が行われるデータベースのプライマリー インスタンスを指します。

   • 読み取り専用エンドポイント (オプション) - 読み取り操作限定で使用されるデータベース エンドポイント。 これは通常、プライマリー インスタンスと同期されているデータベースの 1 つ以上の読み取りレプリカを指します。 読み取り専用のエンドポイントは、負荷を分散して、パフォーマンスと可用性を向上させます。

   • データベース ポート - データベース サーバーが接続を待機しているネットワーク ポート。 デフォルト ポートは 5432 です。

   • ユーザー名 - データベースの認証に使用されるデータベース管理者アカウントのユーザー名。 必要な操作を実行するために必要な権限があることを確認してください。

   • パスワード - データベース管理者のパスワード。

8. 必要に応じて、ストレージ情報の設定 ページの ユーザー管理ストレージの設定 タブで、公開ワークフローをサポートするため、組織サイトの登録済みのデータ フォルダーまたはフォルダーのセットを指定します。

   1. フォルダー データ ストアの名前を入力します。

   2. ドロップダウン メニューから、フォルダーの登録タイプを選択します。

   3. ネットワーク ファイル システム (NFS) を登録している場合は、次の情報を入力します。

      • 公開者のフォルダー パス - ソース データにアクセスでき、ArcGIS Pro などのクライアントから公開できる (ドライブまたは共有の) 場所。

      • NFS ホスト名 - 共有データが格納され、NFS パスを使用してアクセスされるコンピューター名。

      • NFS 共有パス - 共有データが格納され、組織全体でアクセスできるホスト コンピューター上の NFS パス。

   4. 永続ボリューム クレーム (PVC) を登録している場合は、次の情報を入力します。

      • 公開者のフォルダー パス フィールドで、ソース データにアクセスでき、ArcGIS Pro などのクライアントから公開できる共有されている場所を指定します。 ドライブ文字を含む公開者のフォルダー パスを使用している場合は、公開者のフォルダー ホスト名を指定します。

      • ジオコード サービス向けの PV ベースのフォルダー データ ストアを使用している場合は、次の手順を実行します:

        • これはルート検索またはジオコーディング サービスで使用されます ボックスをオンにします。

        • ボリューム パス フィールドに、ローカル PV のノード上のローカル パスを入力します。 ボリューム パスは、永続ボリューム定義ファイルにあります。

      • ジオコード サービスのデータ ストアを使用していない場合は、共有タイプとして Linux または Windows を選択します。

      • Linux を選択した場合は、次の情報を入力します:

        • NFS 共有パス で、共有データが格納され、組織全体でアクセスできるホスト コンピューター上の NFS パスを指定します。 NFS 共有パスは、永続ボリューム定義ファイルにあります。

        • NFS ホスト名 で、共有データが格納され、NFS パスを使用してアクセスされるコンピューター名を指定します。

      • Windows を選択した場合は、ボリューム パス に Windows 共有のソース パスを入力します。 ボリューム パスは、永続ボリューム定義ファイルにあります。

      • PV のボリューム仕様に関する次の情報を指定します。 この情報は、PV にバインドされる永続ボリューム クレーム (PVC) を作成するために使用されます。

        • アクセス モード

        • ストレージ クラス名 (オプション)

        • サイズ (GiB)

        • 永続ボリューム名

        • 永続ボリューム クレーム名 (オプション)

   複数のパスを登録するには、フォルダーの登録 をクリックして、この操作を繰り返します。

   注意:

   後で登録する行為はシステムのダウンタイムにつながるため、フォルダーの登録はこのステップ中に行うことをおすすめします。

9. 次へ をクリックし、構成サマリー ページに表示される構成の詳細のサマリーを確認します。

10. 完了 をクリックして、設定を開始します。

ウィザードの実行中、現在の構成ステータスが表示されます。

構成スクリプトの使用

セットアップ ウィザードを使用する代わりに、サイレントで組織サイトを作成することができます。 ArcGIS Enterprise on Kubernetes をデプロイした後、configure.sh スクリプトを実行できます。

注意:

configure.properties ファイルで使用する暗号化されたパスワードを生成するために、password-encrypt.sh ツールを実行することをおすすめします。

スクリプトの実行

configure.sh スクリプトは、My Esri からダウンロードでき、.tar.gz ファイルとして配布されます。 スクリプトは configure.properties ファイルにバンドルされています。このファイルには、ArcGIS Enterprise 組織サイトへの一意の入力を求める一連のパラメーターと password-encrypt.sh ツールが格納され、ツールは AES-256 で暗号化されたパスワードの生成に使用されます。

configure.sh スクリプトは次のことを実行します:

• configure.properties ファイルのパラメーターが有効であることを確認する

• configure.properties ファイルに保存されている、入力されたストレージ プロパティに基づいて、ストレージの JSON を作成する

• ArcGIS Enterprise 組織の作成

注意:

このスクリプトの実行に使用されるクライアント ワークステーションは、https://<FQDN>/<context>/admin にアクセスできる必要があります。

このスクリプトを実行するには、次の手順を実行します。

1. Kubernetes クライアント コンピューターで、管理者として端末を開きます。

2. <ArcGIS Enterprise on Kubernetes install directory>/tools/configure を参照します。

3. configure.properties ファイルを開きます。

4. ファイルにリストされた各パラメーターの値を入力します。

   ファイルは、次のセクションに分かれています。

   • アーキテクチャー プロファイル

   • 組織

   • ライセンス

   • 暗号化キーファイル

   • 管理者アカウント

   • ログ設定

   • ストレージ

   各ボリュームの推奨ストレージ サイズは、指定した可用性プロファイルによって異なります。

   組織でクラウド リレーショナル ストアまたはクラウド オブジェクト ストアを使用するよう構成するには、CLOUD_CONFIG_JSON_FILENAME パラメーターに .json ファイルへの絶対パスを指定します。 このファイルには、クラウド プロバイダーに関する情報、アクセス認証情報、クラウド サービスの構成が含まれている必要があります。 <ArcGIS Enterprise on Kubernetes install directory>/templates/cloudconfig にあるテンプレートを、さまざまなクラウド プロバイダーや認証パターン向けにこのファイルを正しく書式設定するための例として使用できます。 サービス構成の適切な値を特定する方法については、クラウド プロバイダーのドキュメントをご参照ください。

5. ファイルを保存します。 必要に応じて、ファイルの名前を変更します。

6. 端末で、次のコマンド形式を使用して構成スクリプトを実行します。

   ./configure.sh [options] -f <user_properties>

   • 構成スクリプトで実行するために選択できるオプションの 1 つは、ユーザー管理のデータ ストアを登録するためのオプションです。 ユーザー管理のデータ ストアを登録する場合、次の形式を使用して .json ファイルに組織のデータ フォルダーまたはデータ フォルダーのセットを指定する必要があります:

     注意:

     以下の JSON の例では、クライアントのパスがネットワーク共有を参照しているネットワーク ファイル共有 (NFS) とクライアントのパスがローカル ドライブを参照している NFS の詳細が指定されています。

     [
       {
         "clientPath": "\\\\sample_server\\SharedPath\\Data",
         "type": "folder",
         "info": {
           "fileServerHost": "nfsHost.example.com",
           "fileServerType": "nfs",
           "fileServerPath": "/SharedPath/Data"
         }
       },
       {
         "clientPath": "C:\\data",
         "type": "folder",
         "info": {
           "fileServerHost": "nfsHost.example.com",
           "fileServerType": "nfs",
           "fileServerPath": "/data",
           "hostName": "yourclienthost.example.com"
         }
       }
     ]
     

   • また、次の方法でコマンドの書式に .json ファイルへのパスを追加する必要もあります:

   % ./configure.sh -f my.properties -u /path/to/my_data_stores.json

   <user properties> のコンテンツが configure.properties ファイルから取得されます。

スクリプトを実行すると、構成の詳細情報の概要が表示され、続行するかどうかをたずねられます。

• 「y」を指定すると、スクリプトが続行されて組織サイトが作成されます。 これは、スクリプトが想定するデフォルト入力です。

• 「n」を指定すると、スクリプトが即座に終了し、組織サイトは作成されません。