register コマンドの使用 - AWS OpsWorks

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

register コマンドの使用

重要

この AWS OpsWorks Stacks サービスは 2024 年 5 月 26 日にサポート終了となり、新規および既存のお客様の両方で無効になっています。できるだけ早くワークロードを他のソリューションに移行することを強くお勧めします。移行についてご質問がある場合は、 AWS re:Post または AWS Premium Support を通じて AWS Support チームにお問い合わせください。

注記

この機能は Linux スタックでのみサポートされています。

インスタンスを登録するには、 AWS CLIのバージョンが少なくとも 1.16.180 でなければなりません。register コマンドの一般的な構文を次に示します。


aws opsworks register \
  [--profile profile_name] \
  [--region region_name] \
  --infrastructure-class instance_type \
  --stack-id stack ID \
  [--local] | [--ssh-private-key key_file --ssh-username username] | [--override-ssh command_string] \
  [--override-hostname hostname] \
  [--debug] \
  [--override-public-ip public IP] \
  [--override-private-ip private IP] \
..[--use-instance-profile] \
  [ [IP address] | [hostname] | [instance ID]

以下の引数は、すべての AWS CLI コマンドに共通です。

--profile

(オプション) 認証情報のプロファイル名。この引数を省略すると、コマンドはデフォルトの認証情報を使用して実行されます。がデフォルトの認証情報 AWS CLI を決定する方法の詳細については、「AWS コマンドラインインターフェイスの設定」を参照してください。

--region

（オプション) AWS OpsWorks スタックサービスエンドポイントのリージョン。をスタックのリージョン--regionに設定しないでください。 AWS OpsWorks スタックはスタック ID からスタックのリージョンを自動的に決定します。

注記

デフォルトのリージョンがすでに設定されている場合は、この引数を省略できます。デフォルトのリージョンを指定する方法の詳細については、「AWS コマンドラインインターフェイスの設定」を参照してください。

Amazon EC2 インスタンスとオンプレミス インスタンスのどちらの場合も、以下の引数を使用します。

--infrastructure-class

(必須) このパラメータを ec2 または on-premises のいずれかに設定して、Amazon EC2 インスタンスと オンプレミス インスタンスのどちらを登録するのかを指定する必要があります。

--stack-id

(必須) インスタンスを登録するスタックの ID。

注記

スタック ID を見つけるには、[Stack (スタック)] ページで [Settings (設定)] を選択します。スタック ID には OpsWorks ID というラベルが付けられ、 のような GUID ですad21bce6-7623-47f1-bf9d-af2affad8907。

SSH ログイン引数

register でインスタンスにログインする方法を指定するには、次の引数を使用します。

--local

(オプション) この引数は、コマンドを実行する対象のインスタンスを登録するために使用します。

この場合、register でインスタンスにログインする必要はありません。

--ssh-private-key および --ssh-username

(オプション) 別のワークステーションからインスタンスを登録する場合に、ユーザー名またはプライベートキーファイルを明示的に指定するには、これらの引数を使用します。

  • --ssh-username - この引数は、SSH ユーザー名を指定するために使用します。

    --ssh-username を省略すると、ssh はデフォルトのユーザー名を使用します。

  • --ssh-private-key - この引数は、プライベートキーファイルを明示的に指定する場合に使用します。

    --ssh-private-key を省略すると、ssh は、デフォルトのプライベートキーの使用などの、パスワード不要の認証方法によるログインを試みます。それらの方法のいずれもサポートされていない場合、ssh はパスワードを問い合わせます。ssh で認証がどのように処理されるかの詳細については、「Secure Shell (SSH) 認証プロトコル」を参照してください。

--override-ssh

(オプション) この引数は、別のワークステーションから登録する場合に、カスタムの ssh コマンド文字列を指定するときに使用します。register コマンドは、このコマンド文字列を使用して、登録されたインスタンスにログインします。

ssh の詳細については、「SSH」を参照してください

--override-hostname

（オプション) AWS OpsWorks スタックでのみ使用されるインスタンスのホスト名を指定します。デフォルト値はインスタンスのホスト名です。

--debug

(オプション) 登録処理が失敗した場合にデバッグ情報を提供します。トラブルシューティング情報については、インスタンス登録の問題のトラブルシューティングを参照してください。

--use-instance-profile

(オプション。ただし、Amazon EC2 インスタンスでは強く推奨) register コマンドで、IAM ユーザーを作成するのではなく、アタッチされたインスタンスプロファイルを使用するようにします。このパラメータを追加すると、IAM ユーザーが誤って削除された場合に登録済みインスタンスを管理しようしたときに発生するエラーを回避するうえで役立ちます。

重要

登録プロセス中に作成された IAM ユーザーは、登録されたインスタンスの存続中に必要です。ユーザーを削除すると、 AWS OpsWorks スタックエージェントはサービスと通信できなくなります。--use-instance-profile ユーザーが誤って削除された場合に登録済みインスタンスの管理に関する問題が発生するのを回避するために、 registerコマンドに パラメータを追加して、代わりにインスタンスの組み込みインスタンスプロファイルを使用します。また、 --use-instance-profileパラメータを追加すると、 AWS アカウントアクセスキーを 90 日ごとにローテーションするときにエラーが発生するのを防ぐことができます (推奨されるベストプラクティス）。これは、 AWS OpsWorks エージェントと必要なユーザーが利用できるアクセスキーの不一致を防ぐためです。

Target

(条件付き) ワークステーションからこのコマンドを実行する場合、コマンド文字列の最終値で、次のいずれかの方法で登録ターゲットを指定します。

  • インスタンスのパブリック IP アドレス。

  • インスタンスのホスト名。

  • Amazon EC2 インスタンスの インスタンス ID。

    AWS OpsWorks スタックはインスタンス ID を使用して、インスタンスのパブリック IP アドレスを含むインスタンス設定を取得します。デフォルトでは、 AWS OpsWorks Stacks はこのアドレスを使用して、インスタンスへのログインに使用するsshコマンド文字列を作成します。プライベート IP アドレスに接続する必要がある場合は、--override-ssh を使用してカスタムコマンド文字列を提供する必要があります。例については、ワークステーションからのオンプレミスインスタンスの登録を参照してください。

注記

ホスト名を指定すると、ssh は DNS サーバーを使用して名前を特定のインスタンスに解決します。ホスト名が一意かどうか不確かな場合は、ssh を使用して、ホスト名が正しいインスタンスに解決されることを確認します。

登録するインスタンスからこのコマンドを実行する場合は、インスタンス識別子を省略し、代わりに --local 引数を使用します。

以下の引数は オンプレミス インスタンスの場合のみ使用できます。

--override-public-ip

（オプション) AWS OpsWorks スタックは、指定されたアドレスをインスタンスのパブリック IP アドレスとして表示します。インスタンスのパブリック IP アドレスは変更されません。ただし、インスタンスページでアドレスを選択するなど、ユーザーがコンソールを使用してインスタンスに接続する場合、 AWS OpsWorks スタックは指定されたアドレスを使用します。 AWS OpsWorks スタックは引数のデフォルト値を自動的に決定します。

--override-private-ip

（オプション) AWS OpsWorks スタックは、指定されたアドレスをインスタンスのプライベート IP アドレスとして表示します。インスタンスのプライベート IP アドレスは変更されません。 AWS OpsWorks スタックは引数のデフォルト値を自動的に決定します。