TPA - PuTTY configuration guide
===============================

WindowsでPuTTYを使用して、TPAユーティリティ
tpaexecプロビジョニングによって作成されたAWSインスタンスにSSH接続できます。キーをAmazon
EC2によって生成されたプライベートキー形式 ``.pem`` からPuTTY形式
``.ppk`` に変換する必要があります。

::

   #  Provision the cluster

   [tpa]$ tpaexec provision <clustername>

PuTTYには、キーを必要な形式に変換できるPuTTYgenという名前のツールがあります。

キー変換
--------

キー変換を実行するには、次の手順に従ってください。

プライベートキーを見つけます
^^^^^^^^^^^^^^^^^^^^^^^^^^^^

クラスターディレクトリ\ ``<clustername>``
でプライベートキーを見つけます。この名前には、 ``id_``
が接頭辞を付ける\ ``config.yml`` で設定される\ ``cluster_name``
変数が使用されます。たとえば、 ``cluster_name`` が\ ``testenv1``
に設定されている場合、プライベートキーは\ ``id_testenv1`` になります。

キーを.pemとして保存
^^^^^^^^^^^^^^^^^^^^

プライベートキーファイルをWindowsファイルシステムにコピーし、\ ``.pem``
ファイルとして保存します。同じ例を使用すると、ファイル名は\ ``id_testenv1.pem``
です。ファイルを作成するには、コンテンツをテキストファイルに貼り付けるだけで大丈夫です。

.. _キー変換-1:

キー変換
^^^^^^^^

1. PuTTYgenを起動します。 **Parameters**
   の下で、生成するキーの適切なタイプを選択します。

   -  PuTTYgenの古いバージョンの場合、 **SSH-2 RSA** を選択します。
   -  最近のバージョンの場合、 **RSA** を選択します。

..  Note::
   **SSH-1 (RSA)**は選択しないでください。

2. **Load** を選択します。 **PuTTY Private Key Files (\*.ppk)**
   というラベルのボックスで、 **All Files (\*.\*)** を選択します。

3. ``.pem`` ファイルを選択し、 **Open** を選択します。次に、 **OK**
   を選択します。

4. **Save private key** を選択し、 **Yes**
   を選択してパスフレーズなしでキーの保存に関する警告を無視します。ファイルのサフィックスが\ ``.ppk``
   であることを確認し、\ ``.pem``
   ファイルに使用したのと同じ名前を選択します。同じ例を使用すると、ファイル名は\ ``id_testenv1.ppk``
   です。

PuTTYの構成
-----------

1. PuTTYを起動します。 [Category]ウィンドウで、[ **Session**
   ]を選択します。

2. [ **Host Name** ]パネルに、\ ``<user>@<IP address>`` と入力します。 [
   **Port** ]パネルに、\ ``22`` と入力します。

``<user>`` および\ ``<IP address>`` 値は、
tpaexecプロビジョニングユーティリティによって作成される\ ``<clustername>/ssh_config``
ファイルで見つけることができます。

3. PuTTY カテゴリウィンドウで、 **Connection** を選択します。 **SSH**
   を展開し、 **Auth** を選択します。

4. **認証用の秘密キーファイル** というラベルの付いたパネルで、
   **Browse** を選択します。前に保存した\ ``.ppk`` ファイルを選択し、
   **Open** を選択します。

5. PuTTY カテゴリ **ウィンドウで、** Session **を選択します。** Saved
   Sessions **にセッション名を入力し、** Save \*\* を選択します。

この保存されたセッションを選択することにより、PuTTYを介してAWSホストに接続できるようになりました。
