aircloud ssh는 로컬 터미널에서 실행 중인 컨테이너에 SSH로 접속할 수 있게 해줍니다.
다음과 같은 SSH 고유 워크플로우가 필요할 때 적합합니다.
scp- SSH 터널링
ssh -L기반 포트 포워딩- VS Code Remote SSH
aircloud exec와 달리, SSH 접근은 SSH 키 등록이 필요합니다.
언제 사용하면 좋나요?
다음과 같은 경우aircloud ssh가 적합합니다.
scp로 파일을 전송해야 하는 경우- SSH 포트 포워딩이 필요한 경우
- SSH 기반 IDE 연동이 필요한 경우
- SSH 중심 운영 워크플로우가 필요한 경우
콘솔에서 SSH 키 등록하기
프로젝트 사이드바에서 SSH 키 메뉴로 이동합니다.
- 알아보기 쉬운 이름
- OpenSSH 공개키 전체
- 키를 주입할 엔드포인트
SSH 키 컨테이너별 적용
등록한 SSH 키는 컨테이너(엔드포인트) 단위로 개별 적용할 수 있습니다.- 특정 컨테이너에만 적용: 키를 등록할 때 주입할 엔드포인트를 선택해 해당 컨테이너에만 키가 주입되도록 설정할 수 있습니다.
- 활성화 / 비활성화: 키를 삭제하지 않고 비활성화 상태로 전환할 수 있습니다. 비활성화된 키는 다음 재시작 시 주입되지 않으며, 필요할 때 다시 활성화해 재적용할 수 있습니다.
활성화/비활성화 변경 사항은 컨테이너를 중지 후 다시 시작해야 적용됩니다.
중요한 준비사항
AirCloud 제공 템플릿
일부 AirCloud 제공 템플릿은 Jupyter 또는 코드 환경처럼 기본적으로 SSH를 지원할 수 있습니다.기본 SSH 설정 흐름
1. 로컬에서 키 쌍 생성
2. 공개키 확인
3. 콘솔에서 공개키 등록
AirCloud 콘솔에서:- Project 로 이동
- SSH Keys 열기
- 새 키 추가
- 키를 주입할 엔드포인트 선택
4. 필요 시 엔드포인트 재시작
키를 추가하거나 변경할 때 엔드포인트가 이미 실행 중이었다면, 새 환경변수 주입이 적용되도록 엔드포인트를 중지 후 다시 시작해야 할 수 있습니다.aircloud ssh로 접속하기
기본 접속
특정 identity file 사용
특정 replica 지정
다른 사용자로 접속
터널만 열기
VS Code Remote SSH · scp 등 외부 도구와 함께 사용하기
VS Code Remote SSH,scp, rsync 같은 외부 SSH 도구를 쓰려면, 재사용 가능한 SSH config 항목을 한 번만 등록합니다.