스프링 부트 백엔드 개발 강좌, 깃허브 리포지터리 생성하고 코드 푸시하기

스프링 부트(Spring Boot)는 자바 기반의 웹 애플리케이션을 쉽게 개발할 수 있도록 도와주는 프레임 워크입니다. 이번 강좌에서는 스프링 부트를 활용하여 간단한 백엔드 애플리케이션을 구축하고, 이를 깃허브(GitHub)에 저장하는 방법에 대해 자세히 설명하겠습니다. 우리는 애플리케이션을 개발한 후, 깃허브 리포지터리를 생성하고, 코드를 푸시하는 과정까지 안내할 것입니다.

목차

• 1. 스프링 부트 소개
• 2. 개발 환경 설정
• 3. 간단한 스프링 부트 애플리케이션 만들기
• 4. 깃허브 리포지터리 생성하기
• 5. 코드 푸시하기
• 6. 마무리 및 추가 자료

1. 스프링 부트 소개

스프링 부트는 스프링 프레임워크를 기반으로 하여 빠르고 안정적으로 애플리케이션을 구축할 수 있도록 제공되는 도구입니다. 스프링 부트는 설정을 간소화하고, 자동 구성을 통해 개발자가 최소한의 작업으로 애플리케이션을 실행할 수 있도록 돕습니다.

스프링 부트의 주요 특징은 다음과 같습니다.

• 자동 설정 : 스프링 부트는 프로젝트에 필요한 기본 설정을 자동으로 처리합니다.
• 스타터 의존성 : 다양한 기능을 쉽게 추가할 수 있는 스타터 의존성이 제공됩니다.
• 내장 웹 서버 : 톰캣(Tomcat), 제티(Jetty)와 같은 서버를 내장하여 별도의 설치 없이 애플리케이션을 실행할 수 있습니다.
• 운영 환경에서의 모니터링 및 관리 : 스프링 부트는 운영 환경에서 애플리케이션을 모니터링하고 관리할 수 있는 다양한 기능을 제공합니다.

2. 개발 환경 설정

필수 도구 설치

안정적인 개발 환경을 구성하기 위해서는 다음 도구들이 필요합니다.

• Java Development Kit (JDK): 스프링 부트를 실행하기 위해서는 JDK가 필요합니다. JDK 8 이상 버전을 설치해야 합니다.
• IntelliJ IDEA 또는 Eclipse: 스프링 부트 애플리케이션을 개발하기 위한 IDE입니다. IntelliJ IDEA는 무료와 유료 모두 제공되며, Eclipse는 모든 플랫폼에서 사용할 수 있는 무료 IDE입니다.
• Git: 버전 관리를 위한 도구입니다. Git을 사용하여 코드 변경 사항을 추적하고, 변경 사항을 리모트 저장소에 푸시할 수 있습니다.
• 깃허브 계정: 코드 저장을 위한 깃허브 리포지터리를 만들기 위해 깃허브 계정이 필요합니다. 여기에서 가입할 수 있습니다.

개발 환경 설치 절차

각 도구를 설치하는 방법은 다음과 같습니다.

1. JDK 설치

JDK는 오라클 웹사이트에서 다운로드할 수 있습니다. 운영 체제에 맞는 버전을 선택하여 설치합니다.

2. IDE 설치

IntelliJ IDEA는 JetBrains의 공식 웹사이트에서 다운로드할 수 있으며, Eclipse는 오르그의 웹사이트에서 다운로드 가능합니다. IDE를 설치한 후, JDK 경로를 IDE에 설정합니다.

3. Git 설치

Git은 공식 웹사이트에서 다운로드하여 설치할 수 있습니다. 설치 후, Command Line 또는 Terminal에서 git --version 명령어를 실행하여 설치가 완료되었는지 확인합니다.

3. 간단한 스프링 부트 애플리케이션 만들기

이제 실제로 스프링 부트 애플리케이션을 만들어 보겠습니다. 다음 단계를 통해 애플리케이션을 생성할 수 있습니다.

Step 1: 스프링 초기화

스프링 부트 프로젝트를 초기화하기 위해 Spring Initializr를 사용합니다.

• Project: 선택합니다. (‘Maven Project’ 또는 ‘Gradle Project’)
• Language: ‘Java’를 선택합니다.
• Spring Boot: 최신 스프링 부트 버전을 선택합니다.
• Group: 예를 들어, com.example로 입력합니다.
• Artifact: 원하는 프로젝트 이름을 입력합니다. 예를 들어, my-spring-boot-app로 설정합니다.
• Dependencies: Spring Web를 선택합니다. 필요에 따라 다른 종속성을 추가할 수 있습니다.

설정을 마친 후, Generate 버튼을 클릭하여 ZIP 파일로 프로젝트를 다운로드합니다.

Step 2: IDE에서 프로젝트 불러오기

다운로드한 ZIP 파일을 IDE에서 불러옵니다. 이를 위해 IDE를 열고, File -> Open을 선택하여 ZIP 파일을 열거나, 압축을 푼 후 해당 폴더를 열 수 있습니다.

Step 3: 기본 코드 작성하기

프로젝트 구조가 설정되면 src/main/java/com/example/myspringbootapp/MySpringBootApp.java 파일을 열어 다음과 같은 코드로 업데이트합니다:

package com.example.myspringbootapp;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class MySpringBootApp {

    public static void main(String[] args) {
        SpringApplication.run(MySpringBootApp.class, args);
    }
}

간단한 스프링 부트 애플리케이션의 시작점입니다. 이제 간단한 REST API를 만들어 보겠습니다.

Step 4: REST 컨트롤러 작성하기

먼저, 새로운 클래스 파일 GreetingController.java를 생성합니다. 다음과 같이 작성합니다:

package com.example.myspringbootapp;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class GreetingController {
    
    @GetMapping("/greeting")
    public String greeting(@RequestParam(value = "name", defaultValue = "World") String name) {
        return String.format("Hello, %s!", name);
    }
}

위 코드는 /greeting API 엔드포인트를 생성하며, 쿼리 매개변수로 이름을 전달받아 인사 메시지를 반환합니다.

Step 5: 애플리케이션 실행하기

IDE에서 메인 클래스(MySpringBootApp)를 실행하거나, 터미널에서 다음 명령어를 실행하여 애플리케이션을 시작할 수 있습니다:

./mvnw spring-boot:run

브라우저에 http://localhost:8080/greeting를 입력하여 API를 호출할 수 있습니다. 만약 http://localhost:8080/greeting?name=Alice를 입력하면 “Hello, Alice!”라는 메시지를 받게 됩니다.

4. 깃허브 리포지터리 생성하기

이제 스프링 부트 애플리케이션을 깃허브에 저장할 차례입니다. 그동안 만든 코드를 깃허브에 올리기 위해서는 먼저 깃허브 리포지터리를 생성해야 합니다.

Step 1: 깃허브에 로그인하기

먼저, 깃허브에 로그인합니다. 계정이 없다면 회원가입을 해야 합니다.

Step 2: 새로운 리포지터리 생성하기

로그인 후 오른쪽 상단의 “+” 버튼을 클릭하여 “New repository”를 선택합니다. 리포지터리 이름과 설명을 입력하고, Public이나 Private 옵션을 선택한 후 Create repository 버튼을 클릭합니다.

5. 코드 푸시하기

이제 로컬에서 작성한 코드를 깃허브 리포지터리에 푸시하는 과정에 대해 알아보겠습니다.

Step 1: Git 초기화

프로젝트 폴더로 이동하여 Git을 초기화합니다. 터미널에서 다음 명령어를 실행합니다:

git init

Step 2: 깃허브 리모트 리포지터리 추가하기

계속해서 깃허브에서 생성한 리포지터리의 주소를 추가합니다. 리포지터리의 주소는 깃허브 상단의 URL 표시줄에서 복사할 수 있습니다:

git remote add origin https://github.com/USERNAME/REPOSITORY_NAME.git

여기서 USERNAME은 깃허브 사용자 이름이고, REPOSITORY_NAME은 생성한 리포지터리 이름입니다.

Step 3: 변경 사항 추가 및 커밋하기

변경 사항을 커밋하기 위해 다음 명령어를 실행합니다:

git add .
git commit -m "Initial commit"

Step 4: 코드 푸시하기

마지막으로, 로컬 변경 사항을 깃허브에 푸시합니다:

git push -u origin master

6. 마무리 및 추가 자료

축하합니다! 이제 간단한 스프링 부트 애플리케이션을 만들고, 깃허브 리포지터리에 코드를 푸시하는 방법까지 익혔습니다. 이 과정은 백엔드 개발의 기초를 다지는 중요한 단계입니다.

추가적인 자료와 참고문헌은 다음 링크를 통해 확인할 수 있습니다:

• Spring Boot 공식 문서
• GitHub 시작하기
• Baeldung의 Spring Boot 강좌

이 강좌가 도움이 되었길 바랍니다. 더 나아가고 싶은 분들은 스프링 부트와 Git을 활용하여 다양한 프로젝트에 도전해 보세요!