[AWS] VSCode에서 AWS EC2 원격 연결 / EC2 메모리 부족 해결

터미널로 AWS EC2에 접속해서 서버 코드를 수정하려면 Nano나 Vim 등을 이용해야 한다. 익숙한 VSCode 환경이 아니기 때문에 오타가 발생할 가능성도 높고, 이 에디터들의 기본 설정은 Linter도 안되기 때문에 불편하다. VSCode 확장 기능을 이용해 AWS EC2에 원격 접속한 후 VSCode에서 코드를 직접 수정할 수 있다.

 

VSCode에서 EC2 인스턴스 SSH 연결

---

❶ VSCode 확장기능 Remote SSH 설치 (링크)  

 

❷ CMD SHIFT P 명령 커맨드 → Remote-SSH: Connect to Host → Configure SSH Hosts → 사용자 수준의 config 파일 클릭

 

❸ SSH Config 파일 설정

# 입력 예시
Host aws-ec2-seoul-private
  HostName ec2-88-888-88-888.ap-northeast-2.compute.amazonaws.com
  User ubuntu
  IdentityFile ~/Documents/cert/aws-ec2-seoul-key.pem

 

• Host : 접속 이름(임의 지정)
• HostName : 접속 주소(퍼블릭 IPv4 DNS)
• User : 사용자 이름. 변경하지 않았다며 보통 ubuntu가 기본값
  💡 EC2 인스턴스 → 우측 상단 "연결" 버튼 → "사용자 이름"에서 확인 가능
• IdentityFile : 로컬에 저장한 pem 파일 경로
  💡 권한 에러가 나오면 chmod 400 키이름.pem 으로 소유자 읽기 전용으로 변경 (참고 노트)  

 

❹ CMD SHIFT P 명령 커맨드 → Remote-SSH: Connect to Host → 목록에서 Host 선택 후 연결

좌측 하단 파란색 "원격 창 열기" 버튼을 눌러서 연결할 수도 있다

❺ 좌측 "탐색기" 메뉴 → "폴더 열기" 버튼 클릭 → 원하는 원격 폴더 선택 후 "확인"을 클릭하면 접속 완료

 

❻ 부가기능을 설치하면 생기는 좌측 메뉴의 "원격 탐색기" 목록에 접속했던 원격 폴더가 자동 추가된다. 다음부턴 목록에 마우스 커서를 올리면 나오는 폴더 버튼을 눌러서 바로 연결할 수 있다.

 

 

EC2 인스턴스 메모리 부족 해결

---

무료 EC2 프리티어는 메모리 1GB 용량을 제공한다(인스턴스 유형 t2.micro). 연습용으론 참 좋지만 VSCode 원격 연결 후 서버 파일을 열면 얼마 후 연결이 끊어지면서 서버가 다운되는 현상을 종종 볼 수 있다. 인스턴스의 메모리가 부족해서 생기는 문제다.

 

VSCode로 인스턴스에 연결한 후 서버 파일을 열기 전 아래 명령어를 터미널에 입력해 본다. free는 시스템의 메모리 상태를 확인할 수 있는 명령어다. -h 옵션은 Gi(기가바이트), Mi(메가바이트) 등 읽기 편한 단위로 나오는 옵션이고 -s는 입력한 숫자(초) 간격 만큼 메모리 상태를 반복해서 출력해 주는 옵션이다.

free -h -s 2

 

이제 서버 파일을 열어보면 메모리가 현저하게 줄어드는걸 실시간으로 확인할 수 있다. 메모리가 0이 되는 순간 서버가 죽는 것이다(이땐 EC2 웹에서 수동으로 재부팅해줘야 다시 살아난다).

 

가장 좋은 해결 방법은 메모리 증설이지만 별도 비용이 든다. 연습용 인스턴스에 돈을 쓰는 게 애매하다면 SWAP 메모리를 지정하는 방법으로 이 문제를 해결할 수 있다. RAM이 부족할 때 HDD 공간을 RAM처럼 사용하는 기능이다. 물론 RAM 보단 느리지만, 서버의 가용성을 유지하고 시스템 과부하를 방지할 수 있다. 

 

스왑 공간 계산

먼저 스왑 공간 크기를 계산해야 한다. 스왑 공간은 최소한 32MB를 넘어야 한다. EC2 프리티어의 기본 RAM이 1GB 이므로 2GB 정도의 스왑 공간이 적당하다.

 

• 물리 RAM 2GB 이하 권장 스왑 공간 : RAM 용량의 2배
• 물리 RAM 2GB 초과 32GB 미만 권장 스왑 공간 : 4GB + (RAM - 2GB)
• 물리 RAM 32GB 이상 권장 스왑공간 : RAM 용량의 1배

 

스왑 파일 생성

❶ dd 명령어로 swap 파일 생성. bs는 블록 크기고 count는 블록 수. 128 * 16 = 2048이 스왑 파일의 크기가 된다(이는 곧 스왑 메모리의 크기)

sudo dd if=/dev/zero of=/swapfile bs=128M count=16

 

❷ 스왑 파일의 읽기 / 쓰기 권한 업데이트

sudo chmod 600 /swapfile

 

❸ Linux의 스왑 공간 설정

sudo mkswap /swapfile

 

❹ 스왑 공간에 스왑 파일 추가하여, 스왑 파일을 즉시 사용할 수 있도록 설정

sudo swapon /swapfile

 

❺ 위 절차가 성공했는지 확인

sudo swapon -s

 

❻ /etc/fstab 파일을 편집하여 부팅 시 스왑 파일이 활성화 되도록 설정

nano 등 편집기로 fstab 파일 열기

sudo nano /etc/fstab

 

파일 끝에 아래 코드 추가한 후 저장 / 종료

/swapfile swap swap defaults 0 0

 

완료 후 확인

스왑 설정을 완료하고 터미널에 free -h를 입력해보면 Swap 행이 추가된걸 확인할 수 있다. 물리 메모리를 다 쓰면 Swap 영역의 메모리를 사용한다.

 

 

 

스왑 공간 변경

---

💡 이미 설정했던 스왑 공간을 변경하고 싶을 때 아래 방법 사용

 

❶ 스왑 끄기

sudo swapoff -a

 

❷ 스왑 공간 변경

sudo dd if=/dev/zero of=/swapfile bs=128M count=변경할숫자

 

❸ 스왑 공간 설정

sudo mkswap /swapfile

 

❹ 스왑 파일 사용

sudo swapon /swapfile

 

완료했다면 df -h 명령어로 디스크 공간이 변했는지 확인해 본다. 디바이스 볼륨을 나타내는 /dev/xvda1 부분을 보면 된다. free -h 명령어로 스왑 메모리도 변했는지(증가 or 감소) 체크해보자.

 

 

 

스왑 활용도 조정

---

아래 명령어를 입력하면 0~100 사이의 스왑 활용도(swappiness) 숫자가 나온다. 기본값은 60이다. 숫자가 높을수록 더 적극적으로 스왑을 사용한다.

cat /proc/sys/vm/swappiness # 60

 

값	설명
vm.swappiness = 0	스왑 사용 안함
vm.swappiness = 1	스왑 사용 최소화
vm.swappiness = 60	기본값
vm.swappiness = 100	적극적으로 스왑 사용

 

스압 활용도(swappiness)를 변경하고 싶으면 아래 명령어를 입력해 준다.

sudo sysctl vm.swappiness=숫자

 

 

레퍼런스

---

스왑 파일을 사용하여 Amazon EC2 인스턴스에서 메모리를 스왑 스페이스로 할당합니다.

 

---

글 수정사항은 노션 페이지에 가장 빠르게 반영됩니다. 링크를 참고해 주세요