에디터 접속하기
브라우저에서 바로 코드 에디터에 접속하여 원격 서버의 파일을 편집할 수 있습니다.
에디터 열기
에디터는 작업 세션을 통해 열립니다. 코드 에디터 기능을 포함해 세션을 요청하고, 승인되면 세션에서 에디터를 실행합니다.
- 서버 카드나 상세 페이지에서 연결을 클릭합니다(또는 Sessions를 열어 새 세션을 만듭니다).
- 요청에 코드 에디터 기능을 포함해 제출합니다. 세션 요청하기를 참고하세요.
- 세션이 활성 상태가 되면 세션 탭을 엽니다. 편집할 서버의 에디터 버튼을 누릅니다.
- 새 브라우저 탭에서 에디터가 열립니다.
대시보드의 내 활성 세션에서 시작할 수도 있습니다.
이미 연 에디터로 돌아가려면 탭을 새로고침하거나 에디터 주소를 다시 열거나, 세션의 이어하기 탭에서 다시 연결을 누르세요. 에디터 세션을 참고하세요.
접속 요구사항
- 서버가 커미션되고 온라인 상태여야 합니다
- 서버의 코드 에디터 설정이 켜져 있어야 합니다. 꺼져 있다면 해당 서버의 에디터 버튼에서 열 수 없는 이유를 확인할 수 있습니다. 터널과 코드 에디터를 참고하세요
- 해당 서버에 대해 코드 에디터 기능을 포함한 활성 작업 세션이 있어야 합니다
- 해당 서버에 할당된 그룹에 속해 있어야 합니다(또는 워크스페이스 관리자)
계정 선택
에디터는 세션을 요청할 때 접속 계정에서 고른 계정으로 접속합니다. 기본값은 본인 계정이며, Alpacon 사용자 이름이 원격 사용자로 사용됩니다. 권한이 필요한 작업은 sudo와 MFA를 사용하세요.
에디터는 Windows 서버에서는 사용할 수 없습니다.
고를 수 있는 계정과 본인 계정이 아닌 계정을 쓸 수 있는 사람은 계정 선택을 참고하세요.
본인 계정이 아닌 계정으로 접속할 때의 MFA 인증
워크스페이스가 에디터에 MFA를 요구하면, 본인 계정이 아닌 계정으로 실행되는 세션에서 에디터를 열 때 먼저 MFA 인증을 거칩니다. 본인 계정으로 접속할 때는 필요하지 않습니다.
- 서버 행의 에디터 버튼을 누릅니다
- MFA가 필요하다는 알림이 표시됩니다
- MFA 인증 페이지로 이동합니다
- 인증을 완료합니다(TOTP, 이메일, 전화, WebAuthn)
- 인증에 성공하면 자동으로 원래 화면으로 돌아가 에디터가 열립니다
인증은 워크스페이스가 정한 시간 동안 유지되므로, 그 안에 에디터를 다시 열 때는 다시 인증하지 않아도 됩니다.
최초 접속
에디터를 통해 서버에 처음 접속하면 에디터 환경이 자동으로 설치됩니다. 이 과정은 몇 분 정도 소요될 수 있습니다.
접속 단계:
- 터널 생성 중: 서버와의 연결을 엽니다
- 에디터 준비 중: 서버에 에디터를 설치하거나 준비합니다
- 에디터 시작 중: 에디터를 시작합니다
준비가 끝나면 에디터가 열립니다.
같은 서버에 이후 접속할 때는 환경이 이미 설치되어 있으므로 더 빠르게 연결됩니다.
문제 해결
에디터에 연결 오류가 표시되는 경우:
- 화면에 표시된 이유를 확인하세요. 에디터가 종료되었거나 작업 세션이 더 이상 활성 상태가 아니면 활성 세션에서 에디터를 다시 실행하세요
- 서버가 연결되어 있고 온라인 상태인지 확인하세요
- 재시도를 클릭해 다시 접속해 보세요
- 서버 목록으로를 클릭해 서버 목록으로 돌아가세요
에디터에 에디터 연결이 끊어졌어요 또는 네트워크 연결이 끊어졌어요 안내가 표시되는 경우:
- 다시 연결을 누르세요. 에디터가 아직 실행 중이면 그 에디터로 돌아가고, 이미 종료되었으면 연결 오류 화면에 이유가 표시됩니다. 연결이 끊겼을 때를 참고하세요
에디터 대신 “Bad Gateway” 페이지가 표시되는 경우:
- 연결된 브라우저 탭이 없는 상태로 약 1시간(기본값)이 지나 에디터가 종료된 경우입니다. 작업 세션의 이어하기 탭에서 그 에디터를 종료한 뒤 새로 실행하세요. 에디터 종료하기를 참고하세요
에디터가 에디터 준비 중 단계에서 멈추는 경우:
- 최초 설치에는 몇 분이 걸릴 수 있습니다
- 설치에 실패하면 재시도를 클릭하세요
MFA 인증이 실패하는 경우:
- 워크스페이스에서 허용하는 MFA 방식을 등록했는지 확인하세요
- MFA 장치를 사용할 수 있는지 확인하세요
- 문제가 계속되면 워크스페이스 관리자에게 문의하세요