설명서Commerce클라우드 인프라의 Commerce 안내서

원격 환경에 대한 보안 연결

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 개발자

SSH(Secure Shell)는 원격 서버 및 시스템에 안전하게 로그인하는 데 사용되는 일반적인 프로토콜입니다. SSH를 사용하여 Adobe Commerce 애플리케이션 관리 및 원격 환경 로그 액세스를 위해 원격 환경에 액세스할 수 있습니다. Adobe은 SSH 공개 키를 사용하는 보안 FTP(sFTP) 연결만 지원합니다. FTP 연결은 지원되지 않습니다.

SSH 키 쌍 생성

프로젝트 소스 코드 및 환경에 액세스해야 하는 모든 시스템 및 작업 영역에 SSH 키 쌍을 만듭니다. SSH 키를 사용하면 사용자 이름과 암호를 지속적으로 제공할 필요 없이 GitHub에 연결하여 소스 코드를 관리하고 클라우드 서버에 연결할 수 있습니다. SSH 키 쌍을 만드는 방법에 대한 자세한 내용은 SSH를 사용하여 GitHub에 연결을 참조하십시오.

  • 공개 키 ​은(는) 사이트, SSH 및 sFTP에 액세스하는 데 안전하게 사용할 수 있습니다.
  • 개인 키 ​는 워크스테이션에서 비공개로 유지됩니다.
CAUTION
개인 키를 공유하지 마십시오. 티켓에 추가하지 않거나 채팅에 복사하거나 전자 메일에 첨부하지 않습니다.

계정에 SSH 공개 키 추가

Adobe Commerce on cloud infrastructure 계정에 SSH 공개 키를 추가한 후 계정에 모든 활성 환경을 다시 배포하여 키를 설치합니다.

Cloud CLI 또는 Cloud Console 방법 중 하나를 사용하여 계정에 SSH 키를 추가할 수 있습니다.

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-key:list 및 ssh-key:delete을(를) 사용하여 SSH 키를 나열하고 삭제할 수 있습니다.
콘솔

Cloud Console을(를) 사용하여 SSH 키 추가

새 프로젝트에 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에는 각 환경에 대한 웹 및 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
Pro 스테이징 및 프로덕션 환경의 경우 SSH 명령은 다음과 같을 수 있습니다.
code language-bash 
ssh <node>.ent-<project-ID>-<environment>-<user-ID>@ssh.<region>.magento.com

sFTP

Adobe Commerce on cloud infrastructure는 SSH 인증이 있는 sFTP(보안 FTP)를 사용하여 환경에 액세스할 수 있도록 지원합니다. sFTP용 SSH 키 인증을 지원하는 클라이언트를 사용하고 공개 SSH 키를 사용합니다. 공개 SSH 키를 대상 환경에 추가해야 합니다. Starter 환경 및 Pro 통합 환경의 경우 다음을 통해 추가 Cloud Console할 수 있습니다.

읽기 전용 sFTP 연결은 지원되지 않습니다. sFTP 액세스는 기본적으로 쓰기 권한으로 제공됩니다.

sFTP를 구성할 때 SSH 액세스 환경 명령의 정보를 사용하십시오. <project-id>-<environment-id>--<app-name>@ssh<cloud-host>

  • 사용자 이름: SSH 액세스 대상의 @ 앞에 있는 모든 콘텐츠.
  • 암호: sFTP에는 암호가 필요하지 않습니다. sFTP 액세스는 SSH 키 인증을 사용합니다.
  • 호스트: SSH 액세스에서 @ 이후의 모든 콘텐츠.
  • 포트: 22(기본 SSH 포트).
  • SSH 개인 키: 필요한 경우 sFTP 클라이언트에 개인 키의 위치를 제공하십시오. 기본적으로 개인 키는 ~/.ssh 디렉터리에 저장됩니다.

클라이언트에 따라 sFTP에 대한 SSH 인증을 완료하려면 추가 옵션이 필요할 수 있습니다. 선택한 클라이언트에 대한 설명서를 검토하십시오.

Starter 환경 및 Pro 통합 환경 ​의 경우 특정 디렉터리에 액세스할 수 있도록 mount을(를) 추가하는 것도 고려해 볼 수 있습니다. 마운트를 .magento.app.yaml 파일에 추가합니다. 쓰기 가능한 디렉터리 목록은 프로젝트 구조를 참조하십시오. 이 마운트 지점은 해당 환경에서만 작동합니다.

Pro 스테이징 및 프로덕션 환경 ​의 경우 환경에 대한 SSH 액세스 권한이 없는 경우 Adobe Commerce 지원 티켓을 제출하여 sFTP 액세스를 요청하고 탑재 지점에서 특정 폴더(예: pub/media)에 액세스해야 합니다.

NOTE
Pro Staging 및 프로덕션의 경우, sFTP 연결이 not ​이(가) 필요한 일반 사용자용인 경우클라우드 프로젝트에 추가해야 합니다. 공개 키가 첨부된 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>

예를 들어, 이름이 mymagento인 앱으로 프로젝트의 sprint5 분기에 대한 터널을 열려면 다음을 입력합니다

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