AWS App Runner 는 2026년 4월 30일부터 신규 고객에게 더 이상 공개되지 않습니다. App Runner를 사용하려면 해당 날짜 이전에 가입하세요. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [AWS App Runner 가용성 변경](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html)을 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Ruby 플랫폼 사용
**중요**
App Runner는 2025년 **12월 1일에 Ruby 3.**1에 대한 지원을 종료합니다. 권장 사항 및 자세한 내용은 섹션을 참조하세요[관리형 런타임 버전에 대한 지원 종료](service-source-code.md#service-source-code.managed-platforms.eos).
AWS App Runner Ruby 플랫폼은 관리형 런타임을 제공합니다. 각 런타임을 사용하면 Ruby 버전을 기반으로 웹 애플리케이션을 사용하여 컨테이너를 쉽게 빌드하고 실행할 수 있습니다. Ruby 런타임을 사용하는 경우 App Runner는 관리형 Ruby 런타임 이미지로 시작합니다. 이 이미지는 [Amazon Linux Docker 이미지를](https://hub.docker.com/_/amazonlinux) 기반으로 하며 Ruby 버전 및 일부 도구에 대한 런타임 패키지를 포함합니다. App Runner는이 관리형 런타임 이미지를 기본 이미지로 사용하고 애플리케이션 코드를 추가하여 도커 이미지를 빌드합니다. 그런 다음이 이미지를 배포하여 컨테이너에서 웹 서비스를 실행합니다.
App Runner 콘솔 또는 [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html) API 작업을 사용하여 서비스를 [생성할 때 App Runner 서비스에](manage-create.md) 대한 런타임을 지정합니다. 런타임을 소스 코드의 일부로 지정할 수도 있습니다. 코드 리포지토리에 포함하는 [App Runner 구성 파일의](config-file.md) `runtime` 키워드를 사용합니다. 관리형 런타임의 이름 지정 규칙은 **입니다.
유효한 Ruby 런타임 이름 및 버전은 섹션을 참조하세요[Ruby 런타임 릴리스 정보](service-source-code-ruby-releases.md).
App Runner는 모든 배포 또는 서비스 업데이트 시 서비스의 런타임을 최신 버전으로 업데이트합니다. 애플리케이션에 특정 버전의 관리형 런타임이 필요한 경우 [App Runner 구성 파일의](config-file.md) `runtime-version` 키워드를 사용하여 지정할 수 있습니다. 메이저 또는 마이너 버전을 포함하여 모든 수준의 버전으로를 잠글 수 있습니다. App Runner는 서비스의 런타임만 하위 수준으로 업데이트합니다.
Ruby 런타임용 버전 구문: `major[.minor[.patch]]`
예: `3.1.2`
다음 예제에서는 버전 잠금을 보여줍니다.
+ `3.1` - 메이저 및 마이너 버전을 잠급니다. App Runner는 패치 버전만 업데이트합니다.
+ `3.1.2` - 특정 패치 버전으로 잠급니다. App Runner는 런타임 버전을 업데이트하지 않습니다.
**Topics**
+ [Ruby 런타임 구성](#service-source-code-ruby.config)
+ [Ruby 런타임 예제](#service-source-code-ruby.examples)
+ [Ruby 런타임 릴리스 정보](service-source-code-ruby-releases.md)
## Ruby 런타임 구성
관리형 런타임을 선택할 때는 최소한 빌드 및 실행 명령도 구성해야 합니다. App Runner 서비스를 [생성](manage-create.md)하거나 [업데이트](manage-configure.md)하는 동안 이를 구성합니다. 다음 방법 중 하나를 사용하여이 작업을 수행할 수 있습니다.
+ **App Runner 콘솔 사용** - 생성 프로세스 또는 **구성 탭의 빌드** 구성 섹션에서 명령을 지정합니다.
+ **App Runner API 사용** - [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html) 또는 [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html) API 작업을 호출합니다. [CodeConfigurationValues](https://docs.aws.amazon.com/apprunner/latest/api/API_CodeConfigurationValues.html) 데이터 형식의 `BuildCommand` 및 `StartCommand` 멤버를 사용하여 명령을 지정합니다.
+ **[구성 파일](config-file.md) 사용** - 최대 3개의 빌드 단계에서 하나 이상의 빌드 명령을 지정하고 애플리케이션을 시작하는 데 사용되는 단일 실행 명령을 지정합니다. 추가 선택적 구성 설정이 있습니다.
구성 파일을 제공하는 것은 선택 사항입니다. 콘솔 또는 API를 사용하여 App Runner 서비스를 생성할 때 App Runner가 구성 설정을 생성할 때 직접 가져오거나 구성 파일에서 가져올지 지정합니다.
## Ruby 런타임 예제
다음 예제에서는 Ruby 서비스를 빌드하고 실행하기 위한 App Runner 구성 파일을 보여줍니다.
### 최소 Ruby 구성 파일
이 예제는 Ruby 관리형 런타임과 함께 사용할 수 있는 최소 구성 파일을 보여줍니다. App Runner가 최소 구성 파일로 가정하는 내용은 섹션을 참조하세요[구성 파일 예제](config-file-examples.md#config-file-examples.managed).
**Example apprunner.yaml**
```
version: 1.0
runtime: ruby31
build:
commands:
build:
- bundle install
run:
command: bundle exec rackup --host 0.0.0.0 -p 8080
```
### 확장 Ruby 구성 파일
이 예제에서는 Ruby 관리형 런타임에서 모든 구성 키를 사용하는 방법을 보여줍니다.
**참고**
이 예제에서 사용되는 런타임 버전은 *3.1.2*입니다. 이를 사용하려는 버전으로 바꿀 수 있습니다. 지원되는 최신 Ruby 런타임 버전은 섹션을 참조하세요[Ruby 런타임 릴리스 정보](service-source-code-ruby-releases.md).
**Example apprunner.yaml**
```
version: 1.0
runtime: ruby31
build:
commands:
pre-build:
- scripts/prebuild.sh
build:
- bundle install
post-build:
- scripts/postbuild.sh
env:
- name: MY_VAR_EXAMPLE
value: "example"
run:
runtime-version: 3.1.2
command: bundle exec rackup --host 0.0.0.0 -p 4567
network:
port: 4567
env: APP_PORT
env:
- name: MY_VAR_EXAMPLE
value: "example"
```
### 전체 Ruby 애플리케이션 소스
이 예제에서는 Ruby 런타임 서비스에 배포할 수 있는 전체 Ruby 애플리케이션의 소스 코드를 보여줍니다.
**Example server.rb**
```
# server.rb
require 'sinatra'
get '/' do
'Hello World!'
end
```
**Example config.ru**
```
# config.ru
require './server'
run Sinatra::Application
```
**Example Gemfile**
```
# Gemfile
source 'https://rubygems.org (https://rubygems.org/)'
gem 'sinatra'
gem 'puma'
```
**Example apprunner.yaml**
```
version: 1.0
runtime: ruby31
build:
commands:
build:
- bundle install
run:
command: bundle exec rackup --host 0.0.0.0 -p 4567
network:
port: 4567
env: APP_PORT
```
# Ruby 런타임 릴리스 정보
**중요**
App Runner는 2025년 **12월 1일에 Ruby 3.**1에 대한 지원을 종료합니다. 권장 사항 및 자세한 내용은 섹션을 참조하세요[관리형 런타임 버전에 대한 지원 종료](service-source-code.md#service-source-code.managed-platforms.eos).
이 주제에서는 App Runner가 지원하는 Ruby 런타임 버전의 전체 세부 정보를 나열합니다.
**지원되는 런타임 버전 - 원래 App Runner 빌드**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/apprunner/latest/dg/service-source-code-ruby-releases.html)
**참고**
App Runner는 최근에 릴리스된 특정 주요 런타임에 대해 수정된 빌드 프로세스를 제공합니다. 따라서이 문서의 특정 섹션에 *수정된 App Runner 빌드* 및 *원래 App Runner 빌드*에 대한 참조가 표시됩니다. 자세한 내용은 단원을 참조하십시오[관리형 런타임 버전 및 App Runner 빌드](service-source-code.md#service-source-code.build-detail).