Scala for Backend Engineering & Functional Programming · 강의

애플리케이션 제공하기

함수형 웹 서버를 실행해 보세요.

레슨 4/413개 단계

애플리케이션 제공하기은(는) CoddyKit의 무료 Scala for Backend Engineering & Functional Programming 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Scala for Backend Engineering & Functional Programming 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Scala for Backend Engineering & Functional Programming 강의에는 총 4개의 강의가 포함되어 있습니다.

Ember 서버

http4s는 백엔드에서 HttpApp[F]을 실행합니다. 현재 기본적으로 권장되는 선택지는 cats-effect와 fs2를 기반으로 하는 순수 Scala 서버 Ember이며, org.http4s.ember.server.EmberServerBuilder로 사용할 수 있습니다.

오래된 앱에서는 Blaze를 사용할 수도 있지만, 앞으로는 Ember가 권장되는 방식입니다.

// build.sbt
// "org.http4s" %% "http4s-ember-server" % http4sV

서버 빌드

EmberServerBuilder.default[F]는 유창한 방식으로 구성할 수 있는 빌더를 제공합니다. 호스트와 포트를 바인딩하고 앱을 연결한 다음 .build를 호출하면 Resource[F, Server]를 얻습니다.

Resource를 사용하면 종료할 때 소켓이 해제됩니다.

import com.comcast.ip4s._
import org.http4s.ember.server.EmberServerBuilder

EmberServerBuilder.default[IO]
  .withHost(ipv4"0.0.0.0")
  .withPort(port"8080")
  .withHttpApp(app)
  .build

ip4s 리터럴

Ember는 타입 안전한 네트워킹을 위해 ip4s 타입을 사용합니다. ipv4"..." 및 port"..." 보간기는 컴파일 시점에 유효성을 검사하므로 잘못된 주소나 범위를 벗어난 포트는 컴파일되지 않습니다.

사용하려면 com.comcast.ip4s._를 임포트합니다.

import com.comcast.ip4s._

val host = host"localhost"
val p    = port"8080"

Resource 수명 주기

서버는 올바르게 열고 닫아야 하는 소켓을 소유하므로 Resource입니다. resource.use(_ => ...)는 내부 효과가 실행되는 동안 서버를 계속 실행합니다.

프로세스가 중단될 때까지 실행하려면 IO.never를 사용합니다.

server.use(_ => IO.never).void

IOApp 진입점

http4s 앱의 기본 클래스는 관리되는 cats-effect 런타임을 제공하는 IOApp을 확장합니다. IO[ExitCode]를 반환하는 run을 구현합니다.

IOApp이 스레드 풀, 신호 처리, 정상적인 종료를 대신 처리합니다.

import cats.effect.{IO, IOApp, ExitCode}

object Main extends IOApp {
  def run(args: List[String]): IO[ExitCode] = ???
}

완전한 메인 프로그램

모든 것을 결합해 보겠습니다. 서버 리소스를 빌드한 다음 IO.never와 함께 use하여 프로세스를 계속 실행하고 ExitCode.Success를 반환합니다.

이것이 http4s의 표준 진입점입니다.

def run(args: List[String]): IO[ExitCode] =
  EmberServerBuilder.default[IO]
    .withPort(port"8080")
    .withHttpApp(app)
    .build
    .use(_ => IO.never)
    .as(ExitCode.Success)

리소스 조합

실제 앱은 서버 외에도 데이터베이스 풀, HTTP 클라이언트, 설정 등을 확보합니다. Resource에 대한 단일 for-컴프리헨션으로 이들을 조합하면 모두 역순으로 해제됩니다.

확보한 클라이언트를 경로 구성에 전달합니다.

for {
  client <- EmberClientBuilder.default[IO].build
  app     = buildApp(client)
  srv    <- serverResource(app)
} yield srv

정상적인 종료

서버가 Resource 안에 있으므로, IOApp에서 SIGTERM을 받는 경우처럼 파이버를 취소하면 연결 수락을 중지하고 소켓을 닫는 정리 작업이 실행됩니다.

Ember는 구성 가능한 종료 시간 제한 안에 처리 중인 요청을 마무리합니다.

EmberServerBuilder.default[IO]
  .withShutdownTimeout(30.seconds)
  .withHttpApp(app)
  .build

서버 미들웨어

최종 HttpApp을 서버 미들웨어로 감싼 후 빌더에 전달합니다. 일반적인 미들웨어로는 Logger, CORS, GZip, ErrorHandling이 있습니다.

순서가 중요합니다. 가장 바깥쪽 래퍼가 요청을 먼저 보고 응답을 마지막에 봅니다.

import org.http4s.server.middleware._

val finalApp = Logger.httpApp(true, false)(
  CORS.policy.withAllowOriginAll(app)
)

구성

ciris 또는 pureconfig 같은 구성 라이브러리를 사용해 환경에서 호스트, 포트, 비밀 값을 읽고, 구성을 Resource 또는 효과의 일부로 반환합니다.

같은 바이너리가 여러 환경에서 실행되도록 포트를 코드에 직접 지정하지 않습니다.

val port = sys.env.get("PORT")
  .flatMap(Port.fromString)
  .getOrElse(port"8080")

상태 확인과 관측 가능성

200을 반환하는 GET /health 같은 활성 상태 경로를 노출하여 오케스트레이터가 프로세스를 확인할 수 있게 합니다. 가시성을 위해 요청 기록 및 메트릭 미들웨어를 추가합니다.

상태 확인은 비용이 적고 외부 의존성이 없도록 유지하여, 하위 서비스가 아닌 프로세스의 상태를 반영하게 합니다.

val health = HttpRoutes.of[IO] {
  case GET -> Root / "health" => Ok("UP")
}

빠른 확인

서버를 Resource로 모델링하는 이유를 떠올려 보세요.

인터랙티브 레슨에서 답해보세요

복습

EmberServerBuilder로 앱을 제공하고, ip4s 리터럴을 사용해 바인딩했으며, build.use(_ => IO.never)를 사용하는 IOApp에서 실행했습니다.

리소스를 조합하고 미들웨어로 감쌌으며, 환경에서 구성을 읽고 상태 확인 경로를 추가했습니다. 또한 정상적인 종료는 Resource에 맡겼습니다.

무료로 시작

AI 튜터와 함께 Scala을(를) 배우세요 — 무료

브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.

코스: 39
레슨: 143

무료로 학습 시작 전체 코스 보기

자주 묻는 질문

“애플리케이션 제공하기” 강의는 무료인가요?

네 — “애플리케이션 제공하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Scala for Backend Engineering & Functional Programming 강의 전체를 잠금 해제할 수 있습니다. Scala for Backend Engineering & Functional Programming 강의에는 총 4개의 강의가 포함되어 있습니다.

“애플리케이션 제공하기”에서 뭘 배우나요?

함수형 웹 서버를 실행해 보세요. 브라우저에서 직접 실행하는 실습 코드로 Scala for Backend Engineering & Functional Programming을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Scala for Backend Engineering & Functional Programming을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Scala for Backend Engineering & Functional Programming은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.

“애플리케이션 제공하기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Scala for Backend Engineering & Functional Programming 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Scala for Backend Engineering & Functional Programming 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Scala for Backend Engineering & Functional Programming(으)로 돌아가기