[EC2] 🚀 AWS EC2에서 Spring Boot application.yml 수정하기

Spring Boot 프로젝트를 AWS EC2에 배포해서 운영하다 보면,
DB 접속 정보나 JWT Secret 같은 설정을 바꾸기 위해 application.yml 파일을 수정해야 할 때가 있습니다.
이번 글에서는 EC2에서 application.yml 수정하는 여러 가지 방법을 정리합니다.

---

1. EC2에 접속하기

먼저 EC2에 SSH로 접속합니다.

 

ssh -i <key.pem> ec2-user@<EC2_PUBLIC_IP>

• <key.pem> : EC2 생성 시 발급받은 키 파일
• <EC2_PUBLIC_IP> : EC2 퍼블릭 IP 주소

접속 후 application.yml 파일이 있는 디렉토리로 이동합니다.

 

cd /home/ec2-user/app/

---

2. 서버 안에서 직접 수정하기

(1) vi 편집기

가장 기본적인 편집기입니다.

vi application.yml

• i → 편집 모드
• 수정 후 Esc → :wq → 저장 & 종료

(2) nano 편집기 (추천 👍)

vi가 익숙하지 않다면 nano를 쓰면 편합니다.

nano application.yml

• 화살표 키로 이동 가능
• 수정 후 Ctrl + O (저장) → Enter → Ctrl + X (종료)

(3) sed로 특정 줄만 수정

간단한 문자열 치환은 sed 명령어로 가능합니다.

sed -i 's/username: old/username: new/' application.yml

---

3. 로컬에서 수정 후 업로드하기

서버 안에서 편집이 불편하다면, 로컬에서 파일을 고친 뒤 EC2에 다시 업로드하면 됩니다.

(1) scp 명령어

scp -i <key.pem> application.yml ec2-user@<EC2_PUBLIC_IP>:/home/ec2-user/app/

(2) sftp 사용

sftp -i <key.pem> ec2-user@<EC2_IP> put application.yml /home/ec2-user/app/

---

4. VS Code Remote - SSH 사용하기

개발 환경이 VS Code라면 Remote - SSH 확장을 설치하면 로컬처럼 바로 서버 파일을 편집할 수 있습니다.

1. VS Code에서 확장 설치: Remote - SSH
2. EC2 접속 정보 등록
3. EC2에 접속 → application.yml을 열고 편집

👉 자주 설정을 바꿀 때는 이 방법이 가장 편리합니다.

---

5. 수정 후 서버 재시작

설정 파일을 수정했으면 Spring Boot 애플리케이션을 재시작해야 반영됩니다.

Docker 실행 중일 때

docker-compose restart

(혹은 docker restart <컨테이너명>)

---

✅ 정리

• 빠르게 수정 → nano application.yml
• 여러 줄 수정 → 로컬에서 편집 후 scp로 업로드
• 자주 수정 → VS Code Remote - SSH 연결