ドキュメントCommerceクラウドインフラストラクチャー上の Commerce に関するガイド

リモート環境への安全な接続

Last update: Thu May 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • Developer

Secure Shell （SSH）は、リモートサーバーおよびシステムに安全にログインするために使用される共通プロトコルです。 SSH を使用してリモート環境にアクセスし、Adobe Commerce アプリケーションを管理してリモート環境ログにアクセスできます。 Adobeでは、SSH 公開鍵を使用したセキュア FTP （sFTP）接続のみをサポートしています。 FTP 接続はサポートされていません。

SSH キーペアの生成

プロジェクトのソースコードと環境にアクセスする必要があるすべてのマシンとワークスペースに、SSH キーペアを作成します。 SSH キーを使用すると、GitHub に接続してソースコードを管理したり、クラウドサーバーに接続したりできます。ユーザー名やパスワードを常に指定する必要はありません。 参照： SSH を使用した GitHub への接続 ssh キーペアの作成に関する詳細な手順。

  • この 公開鍵 は、サイト、SSH、sFTP にアクセスする場合に提供しても安全です。
  • この 秘密鍵 ワークステーションのプライベート状態を維持します。
CAUTION
秘密鍵は決して共有しないでください。 チケットに追加したり、チャットにコピーしたり、メールに添付したりしないでください。

SSH 公開鍵をアカウントに追加

クラウドインフラストラクチャアカウント上のAdobe Commerceに SSH 公開鍵を追加した後、アカウント上のすべてのアクティブな環境を再デプロイして鍵をインストールします。

次のいずれかの方法を使用して、アカウントに SSH キーを追加できます。Cloud CLI または Cloud Console.

CLI

Cloud CLI を使用して SSH キーを追加する

  1. ローカルワークステーションで、をプロジェクトディレクトリに変更します。

  2. プロジェクトへのログイン

    code language-bash 
    magento-cloud login

  3. 公開鍵を追加します。

    code language-bash 
    magento-cloud ssh-key:add ~/.ssh/id_rsa.pub
note tip
TIP
Cloud CLI コマンドを使用して、SSH キーの一覧表示と削除を行うことができます ssh-key:list および ssh-key:delete.
コンソール

を使用して SSH キーを追加する Cloud Console

新しいプロジェクトに SSH キーを追加するには:

  1. にログインします Cloud Console.

  2. クリック No SSH key. このアイコンはコマンドフィールドの右側にあり、プロジェクトに SSH キーが含まれていない場合に表示されます。

  3. に SSH 公開鍵の内容をコピーして貼り付けます。 公開鍵 フィールド。

  4. 残りのプロンプトに従います。

クラウドプロファイルに SSH キーを追加するには:

  1. にログインします Cloud Console.

  2. 右上のアカウントメニューで、 マイプロファイル.

  3. が含まれる SSH キー 表示、クリック 公開鍵を追加.

  4. が含まれる SSH キーの追加 フォーム、キーを タイトル ​に、SSH 公開鍵を貼り付けます。 キー フィールド。

  5. クリック 保存.

リモート環境への接続

リモート環境に接続するには、 magento-cloud CLI または SSH コマンド。 この magento-cloud CLI コマンドは、Starter および Pro 統合環境でのみ使用できます。

Cloud CLI の使用

リモート統合環境にログインするには:

  1. ローカルワークステーションで、をプロジェクトディレクトリに変更します。

  2. そのプロジェクト内の環境をリストします。

    code language-bash 
    magento-cloud environment:list -p <project-ID>

  3. SSH を使用してリモート環境にログインします。

    code language-bash 
    magento-cloud ssh -p <project-ID> -e <environment-ID>

SSH コマンドの使用

この Cloud Console 各環境の Web および SSH アクセス・コマンドのリストが含まれています。

SSH コマンドをコピーするには、次の手順に従います:

  1. にログインします Cloud Console.

  2. 「」からプロジェクトを選択 すべてのプロジェクト リスト。

  3. 環境を選択します。

  4. クリック SSH.

  5. が含まれる SSH タブをクリックし、「コピー」ボタンをクリックして、完全な SSH コマンドをクリップボードにコピーします。

  6. ターミナルを開き、SSH コマンドを貼り付けて接続を作成します。

    code language-bash 
    ssh abcdefg123abc-branch-a12b34c--mymagento@ssh.us-2.magento.cloud
TIP
ステージング環境および実稼動環境では、SSH コマンドは次のようになります。
code language-bash 
ssh <node>.ent-<project-ID>-<environment>-<user-ID>@ssh.<region>.magento.com

sFTP

クラウドインフラストラクチャー上のAdobe Commerceでは、SSH 認証を使用した sFTP （セキュア FTP）を使用した環境へのアクセスをサポートしています。 sFTP 用の SSH キー認証をサポートするクライアントを使用し、SSH 公開キーを使用します。 SSH 公開鍵をターゲット環境に追加する必要があります。 スターター環境と Pro 統合環境の場合は、次のことができます を使用して追加 Cloud Console.

読み取り専用の sFTP 接続 ではない サポート。sFTP アクセスはで提供 write 権限のデフォルト。

sFTP の設定時には、SSH アクセス環境コマンドからの情報を使用します。 <project-id>-<environment-id>--<app-name>@ssh<cloud-host>

  • ユーザー名：次より前のすべてのコンテンツ @ SSH アクセス先で行います。
  • パスワード:sFTP 用のパスワードは必要ありません。 sFTP アクセスでは、SSH キー認証を使用します。
  • ホスト：次の期間より後のすべてのコンテンツ @ SSH アクセス権で。
  • ポート: 22 （デフォルトの SSH ポート）。
  • SSH 秘密鍵：必要に応じて、秘密鍵の場所を sFTP クライアントに指定します。 デフォルトでは、秘密鍵はに保存されます ~/.ssh ディレクトリ。

クライアントによっては、sFTP の SSH 認証を完了するために、追加のオプションが必要になる場合があります。 選択したクライアントのドキュメントを確認します。

の場合 スターター環境と Pro 統合環境 ​の場合も、次の点を考慮してください。 の追加 mount 特定のディレクトリにアクセスする場合。 マウントを .magento.app.yaml ファイル。 書き込み可能なディレクトリのリストについては、を参照してください プロジェクト構造. このマウントポイントは、これらの環境でのみ機能します。

の場合 ステージング環境と実稼動環境 ​環境に対する SSH アクセス権がない場合は、次の操作を行う必要があります Adobe Commerce サポートチケットを送信 特定のフォルダーにアクセスするために、sFTP アクセスおよびマウントポイントをリクエストします（例：）。 pub/media.

NOTE
Pro ステージング環境および実稼動環境では、sFTP 接続が 汎用 実行するユーザー ではない ～である必要がある がクラウドプロジェクトに追加されましたは、次の操作が必要です Adobe Commerce サポートチケットを送信 と共に パブリック キーが添付されました。 SSH 秘密鍵を決して入力しないでください。

SSH トンネリング

SSH トンネリングを使用すると、ローカル開発環境からサービスに対して、サービスがローカルであるかのように接続できます。 トンネリングを行う前に、 SSH.

ターミナルアプリケーションを使用してログインし、コマンドを発行します。

magento-cloud login

を使用してトンネルが開いているかどうかを確認します。

magento-cloud tunnel:list

トンネルを構築するには、 アプリケーション名. アプリケーション名は、CLI を使用して確認できます。

magento-cloud apps

SSH トンネルのセットアップ

magento-cloud tunnel:open -e <environment-ID> --app <app-name>

たとえば、へのトンネルを開くには sprint5 という名前のアプリを使用したプロジェクトのブランチ mymagento、と入力します

magento-cloud tunnel:open -e sprint5 --app mymagento

応答の例：

SSH tunnel opened on port 30004 to relationship: redis
SSH tunnel opened on port 30005 to relationship: database
Logs are written to: /home/magento_user/.magento/tunnels.log

List tunnels with: magento-cloud tunnels
View tunnel details with: magento-cloud tunnel:info
Close tunnels with: magento-cloud tunnel:close

トンネルに関する情報を表示するには:

magento-cloud tunnel:info -e <environment-ID>

サービスへの接続

SSH トンネルを確立すると、ローカルで実行されているかのようにサービスに接続できます。 例えば、データベースに接続するには、次のコマンドを使用します。

mysql --host=127.0.0.1 --user='<database-username>' --pass='<user-password>' --database='<name>' --port='<port>'
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26