Google Cloud Platform への PowerShell デプロイ

PowerShell コマンドは、Unified Access Gateway 2103 以降を Google Cloud Platform 内の Compute Engine にデプロイするために使用されます。

手順

1. クライアント マシンの準備
2. Google Cloud Platform 環境の準備
3. Google Cloud Platform への Unified Access Gateway イメージのアップロード
4. Google Cloud Platform にデプロイするための .ini ファイルの準備
5. Compute Engine へのデプロイ

ステップ 1：PowerShell デプロイのためのクライアント マシンの準備

クライアント マシンに Google Cloud ユーティリティをインストールします。

1. gsutil をインストールします。Windows および Ubuntu に gsutil ツールをインストールする手順については、Google Cloud ドキュメントの「Google Cloud CLI の一部として gsutil をインストールする」を参照してください。

2. Windows マシンの場合は、管理者権限で次の PowerShell コマンドを実行します。

   Install-Package 7Zip4PowerShell
   

PowerShell デプロイ スクリプトを実行するための推奨オペレーティング システム

次の表に、Google Cloud Platform への PowerShell ベースの Unified Access Gateway デプロイを実行できるオペレーティング システムを示します。これは、Unified Access Gateway アプライアンス自体のオペレーティング システムを指すものではありません。

ステップ 2：Google Cloud Platform 環境の準備

Google Cloud プロジェクトを使用します。このプロジェクトに VPC ネットワーク、対応するサブネット ネットワーク、およびファイアウォール ルールを構成する必要があります。詳細については、Google Cloud ドキュメントを参照してください。

前提条件

• Google Cloud Platform の概念を理解していることを確認します。
• Google Cloud プロジェクトで、イメージ、VPC ネットワーク、サブネット、ファイアウォール ルールなどのリソースを作成または変更するために必要な権限があることを確認します。
• Compute Engine API を有効にする必要があります。

手順

1. Google Cloud プロジェクトを使用します。

   オプション	アクション
   新しいプロジェクト	Google Cloud Console で、[プロジェクト セレクタ] ページに移動します。 Google Cloud プロジェクトを作成します。
   既存のプロジェクト	プロジェクトがすでに使用可能でアクティブな場合は、既存のプロジェクトを使用できます。

2. NIC ごとに Virtual Private Cloud (VPC) ネットワークを作成します。

   Unified Access Gateway の各 NIC は、一意の VPC ネットワークとそのネットワーク内のサブネットを使用します。

   VPC ネットワークを作成しない場合は、単一の NIC を持つ Unified Access Gateway のみをデプロイできます。Compute Engine にデプロイされた Unified Access Gateway アプライアンスは、Google Cloud Platform で使用可能なデフォルトの VPC ネットワークを使用します。

   たとえば、次の図では、Google Cloud Console に 2 つの VPC ネットワーク、uag-front-vpc と uag-back-vpc が作成されています。これらの VPC ネットワークには、それぞれサブネットとして uag-front-network と uag-back-network があります。2 つの NIC を持つ Unified Access Gateway アプライアンスをデプロイして、フロントエンド インターネットに接続するためにこれら 2 つのサブネットを使用し、バックエンド接続に個別のサブネット ネットワークを使用できます。

   

   **注：**共有 VPC ネットワークを使用して Unified Access Gateway を構成することもできます。このような場合、サービス プロジェクトにデプロイされた Unified Access Gateway インスタンスは、ホスト プロジェクトで作成および管理される共有 VPC ネットワークに接続されます。Unified Access Gateway の各ネットワーク インターフェイス (NIC) は、共有 VPC ネットワークまたはローカル VPC ネットワークを使用するように個別に構成できます。詳細については、Google Cloud ドキュメントの「共有 VPC の構成」を参照してください。

3. 作成されたサブネット名を書き留めます。

   VPC ネットワーク内のサブネット名は、PowerShell を使用して Unified Access Gateway をデプロイするときに、.ini ファイルで使用されます。

4. インターネットにアクセス可能な VPC 内の Unified Access Gateway アプライアンスへの TCP および UDP ポート アクセスを許可するには、必要な数のファイアウォール エントリを作成します。

   **重要：**TCP ポート 22 でのインターネットから Unified Access Gateway への SSH リモート アクセスは、ファイアウォールで慎重に制限する必要があります。SSH アクセスが必要な場合、ファイアウォール ルールは、特定の送信元 IP アドレスからのみ、またはアクセスを制御できるクラウド内のジャンプ ボックス仮想マシンから、このアクセスを許可する必要があります。

   たとえば、次の Google Cloud Console の図では、インターネットに接続する VPC ネットワーク uag-front-vpc に uag-horizon-protocols という名前のファイアウォール ルールが作成されています。このファイアウォール ルールは、uag-front-vpc ネットワークに接続されているすべてのインスタンスに適用され、指定されたポートでパブリック インターネットからの TCP および UDP の受信トラフィックを許可します。

   

ステップ 3： Google Cloud Platform への Unified Access Gateway イメージのアップロード

Unified Access Gateway インスタンスを Compute Engine にデプロイするには、Unified Access Gateway アプライアンス ディスク イメージを Google Cloud Platform にアップロードする必要があります。

1. Omnissa Customer Connect から、「Unified Access Gateway (UAG) for vSphere, AWS and Google Cloud」ファイルに移動し、[今すぐダウンロード] をクリックします。
   zip ファイル euc-unified-access-gateway-x.x.x.xxxxxxxxx.ova がローカル マシンにダウンロードされます。

2. PowerShell コマンド ウィンドウを開き、次のコマンドを実行して、前にダウンロードした .ova ファイルから .vmdk ファイルを抽出します。

   • ova-filename は、Customer Connect からダウンロードされた .ova イメージ ファイルです。
   • target-location は、.vmdk ファイルが抽出される場所です。

   Windows	Ubuntu
   expand-7zip ova-filename target-location たとえば、euc-unified-access-gateway-22.12.0.0-42741890_OVF10.ova はダウンロードされたファイルです。ここで、22-12 はバージョン番号、42741890 はビルド番号です。 .vmdk ファイルを C:\temp に抽出するには、次のコマンドを実行します。 expand-7zip C:\temp\euc-unified-access-gateway-22.12.0.0-42741890_OVF10.ova C:\temp\	tar -xvf ova-filename 次に例を示します。 tar -xvf euc-unified-access-gateway-22.12.0.0-42741890_OVF10.ova

3. 次の変数を設定します。

   • $gcImageFile は、手順 2 で抽出した .vmdk ファイルのファイル名です。
   • $gcImageFolder は、.vmdk ファイルのフォルダ パスです。 例：

   
   $gcImageFolder="C:\temp"
   $gcImageFile="euc-unified-access-gateway-22.12.0.0-42741890-system.vmdk"
   $gcBucket="uag-appliance-images"
   $gcImageName=$gcImageFile.Replace("-system.vmdk","").Replace(".", "-")
   gcloud auth login
   gcloud config set project "my-project"
   
   

4. Google Cloud ストレージ バケットを作成します。

   **注：**別の Google Cloud プロジェクトでホストされているコンピューティング イメージを使用して、Unified Access Gateway をデプロイすることもできます。このような場合は、Unified Access Gateway のデプロイ時にコンピューティング イメージ名 ($gcImageName) とホスティング プロジェクト ID を指定します。

   次のコマンドを実行して、同じプロジェクトにストレージ バケットを作成します。

   gsutil mb -l us-east1 gs://$gcBucket
   

   次のコマンドを実行して、別のプロジェクトにストレージ バケットを作成します。

   gsutil mb -l us-east1 gs://$gcBucket -p my-image-hosting-project
   

5. 次のコマンドを使用して、.vmdk イメージを Google Cloud ストレージ バケットにアップロードします。

   gsutil cp $gcImageFolder\$gcImageFile gs://$gcBucket
   

6. アップロードした .vmdk から Compute Engine にアプライアンス イメージを作成します。

   次のコマンドを実行して、同じプロジェクトにイメージをインポートします。

   gcloud compute images import $gcImageName --source-file gs://$gcBucket/$gcImageFile --data-disk
   

   次のコマンドを実行して、別のプロジェクトにイメージをインポートします。

   gcloud compute images import $gcImageName --source-file gs://$gcBucket/$gcImageFile --data-disk --project my-image-hosting-project
   

   **注：**コンピューティング イメージをインポートするときに、インポート ツールによって作成された一時仮想マシンに使用するサブネットを指定できます。次の例に示すように --subnet フラグを使用します。

   gcloud compute images import $gcImageName --source-file gs://$gcBucket/$gcImageFile --data-disk --subnet default
   

   これらのコマンドに関する詳細は、Google Cloud SDK ドキュメントを参照してください。

   前の手順で説明した例を考慮すると、Compute Engine で作成されたアプライアンス イメージは euc-unified-access-gateway-22-12-0-0-42741890 で、22-12 はバージョン番号、42741890 はビルド番号です。

ステップ 4：Google Cloud Platform にデプロイするための .ini ファイルの準備

Unified Access Gateway の Compute Engine PowerShell デプロイ スクリプトは、.ini 構成ファイルからすべての構成設定を読み取ります。このセクションでは、.ini ファイル形式について説明し、デプロイに使用できる設定の例を示します。

.ini ファイルのほとんどのセクションは、他のすべてのハイパーバイザーのデプロイでサポートされている Unified Access Gateway の標準 .ini 設定と同じです。.ini ファイルの詳細については、「PowerShell を使用した Unified Access Gateway アプライアンスのデプロイ」セクションを参照してください。

1. [General] セクションで必要な設定を構成します。「PowerShell デプロイ パラメータ」を参照してください。

   **注：**Google Cloud Platform のデプロイの場合、[General] セクションの次の設定は使用されません。

   • diskMode
   • ds
   • folder
   • netInternet
   • netManagementNetwork
   • netmask0、netmask1、netmask2
   • netBackendNetwork
   • source
   • target
   • ip0、defaultGateway、netmask0、ipmode0
   • v6ip0、v6ipprefix0、v6DefaultGateway

2. .ini ファイルに、新しいグループ [GoogleCloud] と、Google Cloud Platform に固有の必要な設定を追加します。

次の表に、Google Cloud Platform のデプロイに必要な設定（値名）を示します。

sharedVpcForSubnet0=true
sharedVpcForSubnet1=false
sharedVpcForSubnet2=false

例 1：Google Cloud Platform に Unified Access Gateway をデプロイするための INI ファイル定義

[General]
name=uag1
deploymentOption=onenic
sshEnabled=true

[GoogleCloud]
projectId=my-project
imageName=euc-unified-access-gateway-22-12-0-0-42741890
zone=us-central1-a
subnet0=uag-front-network

[Horizon]
proxyDestinationUrl=https://myhorizon.example.com

例 2：Google Cloud Platform に Unified Access Gateway をデプロイするための INI ファイル定義

[General]
name=uag2
deploymentOption=twonic
sshEnabled=true
routes1=10.20.0.0/16 10.2.0.1

[GoogleCloud]
projectId=my-project
imageName=euc-unified-access-gateway-22-12-0-0-42741890
imageProjectId=my-image-hosting-project
zone=us-central1-a
vpcHostProjectId=my-sharedvpc-host-project
subnet0=uag-front-network
sharedVpcForSubnet0=true
subnet1=uag-back-network
sharedVpcForSubnet1=false

[Horizon]
proxyDestinationUrl=https://myhorizon.example.com

ステップ 5：Compute Engine へのデプロイ

uagdeploygce.ps1 PowerShell コマンドを使用して、Unified Access Gateway を Compute Engine にデプロイできます。このコマンドは、.ini ファイルからすべての構成設定を取得し、Unified Access Gateway のインスタンスをデプロイします。

Compute Engine 内の既存のインスタンスの名前が、.ini ファイルの [General] セクションで指定されている名前と同じである場合、PowerShell スクリプトはデプロイ中に既存のインスタンスを削除し、同じ名前の新しい Unified Access Gateway インスタンスを作成します。この置き換えは、Unified Access Gateway アプライアンスのアップグレード中、または更新された設定でアプライアンスを再デプロイする際に役立ちます。

1. Omnissa Customer Connect から、Unified Access Gateway (UAG) PowerShell スクリプト ファイルに移動し、[今すぐダウンロード] をクリックします。
   zip ファイル uagdeploy-xx.xx.x.x-xxxxxxxx がローカル マシンにダウンロードされます。

2. zip ファイルを解凍します。次の PowerShell スクリプトがマシン上で使用可能であることを確認します。
   Windows マシンの uagdeploygce.ps1 と uagdeploy.psm1。

3. PowerShell コマンド ウィンドウを起動し、ダウンロードしたスクリプトを含むフォルダにディレクトリを変更します。

4. Unified Access Gateway を Compute Engine にデプロイするには、次の手順を実行します。

   1. 新しいバージョンの Unified Access Gateway にアップグレードする場合は、.ini ファイルを編集して、imageName 設定を前のタスクのいずれかで Compute Engine にアップロードされた新しいイメージ名に更新します。

      .ini ファイル内のその他の構成パラメータはすべて同じままにする必要があります。

   2. インタラクティブ モードと非インタラクティブ モードのどちらを選択したかに応じて、次のコマンドを実行します。

      モード	コマンド
      インタラクティブ	.\uagdeploygce.ps1 <ini-filename>.ini <ini-filename> は、前のタスクで準備した .ini ファイルの名前です。 例：.\uagdeploygce.ps1 uag1.ini uag1.ini は、前のタスクで使用したファイル名です。
      非インタラクティブ	.\uagdeploygce.ps1 <ini-filename> <root-pwd> <admin-pwd> <ceip-yes-no> .\uagdeploygce.ps1 <ini-filename> <secret> <admin-pwd> yes <ini-filename> は、前のタスクで準備した .ini ファイルの名前です。 コマンドに示すようにパスワードがコマンド ラインで指定されている場合は、Unified Access Gateway をデプロイした後に Clear-History PowerShell コマンドを使用します。 パスワードが弱い場合、デプロイは失敗します。パスワードには、「! @ # $ % * ( ) 」のいずれか 1 つを含める必要があります。

      uagdeploygce.ps1 コマンドを再度実行すると、以前の Unified Access Gateway インスタンスと関連リソースが削除され、同じ名前の新しいインスタンスに置き換えられます。新しい .ini ファイルには、最初の起動時に Unified Access Gateway アプライアンスを本番環境で使用できるように、必要なすべての構成パラメータが必要です。

root ユーザーと管理者パスワードの要件の詳細については、「パスワード要件」を参照してください。

次のタスク

Unified Access Gateway を Compute Engine にデプロイし、すべての設定を適用した後、Google Cloud で Unified Access Gateway アプライアンスの構成設定を適用するために使用されるメタデータを削除する必要があります。メタデータを削除するには、例に示すように次のコマンドを使用します。

$uagName=uag1
$zone=us-central1-a
$projectId=my-project
gcloud compute instances remove-metadata $uagName --zone=$zone --project $projectId --keys "user-data"