

AWS App Runner tidak akan lagi terbuka untuk pelanggan baru mulai 30 April 2026. Jika Anda ingin menggunakan App Runner, daftar sebelum tanggal tersebut. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat [perubahan AWS App Runner ketersediaan](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html).

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menggunakan platform Ruby
<a name="service-source-code-ruby"></a>

**penting**  
App Runner akan mengakhiri dukungan untuk **Ruby 3.1** pada 1 Desember 2025. Untuk rekomendasi dan informasi lebih lanjut, lihat[Akhir dukungan untuk versi runtime terkelola](service-source-code.md#service-source-code.managed-platforms.eos).

Platform AWS App Runner Ruby menyediakan runtime terkelola. Setiap runtime memudahkan untuk membangun dan menjalankan container dengan aplikasi web berdasarkan versi Ruby. Saat Anda menggunakan runtime Ruby, App Runner dimulai dengan gambar runtime Ruby yang dikelola. Gambar ini didasarkan pada image [Amazon Linux Docker](https://hub.docker.com/_/amazonlinux) dan berisi paket runtime untuk versi Ruby dan beberapa alat. App Runner menggunakan image runtime terkelola ini sebagai image dasar, dan menambahkan kode aplikasi Anda untuk membuat image Docker. Kemudian menyebarkan gambar ini untuk menjalankan layanan web Anda dalam sebuah wadah.

 Anda menentukan runtime untuk layanan App Runner saat [membuat layanan](manage-create.md) menggunakan konsol App Runner atau operasi API. [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html) Anda juga dapat menentukan runtime sebagai bagian dari kode sumber Anda. Gunakan `runtime` kata kunci dalam [file konfigurasi App Runner](config-file.md) yang Anda sertakan dalam repositori kode Anda. Konvensi penamaan runtime terkelola adalah*<language-name><major-version>*. 

Untuk nama dan versi runtime Ruby yang valid, lihat. [Informasi rilis runtime Ruby](service-source-code-ruby-releases.md)

App Runner memperbarui runtime untuk layanan Anda ke versi terbaru pada setiap penerapan atau pembaruan layanan. Jika aplikasi Anda memerlukan versi tertentu dari runtime terkelola, Anda dapat menentukannya menggunakan `runtime-version` kata kunci dalam file [konfigurasi App Runner](config-file.md). Anda dapat mengunci ke tingkat versi apa pun, termasuk versi mayor atau minor. App Runner hanya membuat pembaruan tingkat yang lebih rendah ke runtime layanan Anda.

Sintaks versi untuk runtime Ruby: `major[.minor[.patch]]`

Misalnya: `3.1.2`

Contoh berikut menunjukkan penguncian versi:
+ `3.1`— Kunci versi mayor dan minor. App Runner hanya memperbarui versi tambalan.
+ `3.1.2`— Kunci ke versi patch tertentu. App Runner tidak memperbarui versi runtime Anda.

**Topics**
+ [Konfigurasi runtime Ruby](#service-source-code-ruby.config)
+ [Contoh runtime Ruby](#service-source-code-ruby.examples)
+ [Informasi rilis runtime Ruby](service-source-code-ruby-releases.md)

## Konfigurasi runtime Ruby
<a name="service-source-code-ruby.config"></a>

Saat memilih runtime terkelola, Anda juga harus mengonfigurasi, seminimal mungkin, membangun dan menjalankan perintah. Anda mengonfigurasinya saat [membuat](manage-create.md) atau [memperbarui](manage-configure.md) layanan App Runner. Anda dapat melakukan ini menggunakan salah satu metode berikut:
+ **Menggunakan konsol App Runner** — Tentukan perintah di bagian **Configure build** pada tab proses pembuatan atau konfigurasi.
+ **Menggunakan App Runner API** — Panggil operasi [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)atau [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)API. Tentukan perintah menggunakan `BuildCommand` dan `StartCommand` anggota tipe [CodeConfigurationValues](https://docs.aws.amazon.com/apprunner/latest/api/API_CodeConfigurationValues.html)data.
+ **Menggunakan [file konfigurasi](config-file.md)** — Tentukan satu atau beberapa perintah build hingga tiga fase build, dan satu perintah run yang berfungsi untuk memulai aplikasi Anda. Ada pengaturan konfigurasi opsional tambahan.

Menyediakan file konfigurasi adalah opsional. Saat membuat layanan App Runner menggunakan konsol atau API, Anda menentukan apakah App Runner mendapatkan setelan konfigurasi secara langsung saat dibuat atau dari file konfigurasi.

## Contoh runtime Ruby
<a name="service-source-code-ruby.examples"></a>

Contoh berikut menunjukkan file konfigurasi App Runner untuk membangun dan menjalankan layanan Ruby. 

### File konfigurasi Ruby minimal
<a name="service-source-code-ruby.examples.minimal"></a>

Contoh ini menunjukkan file konfigurasi minimal yang dapat Anda gunakan dengan runtime terkelola Ruby. Untuk asumsi yang dibuat oleh App Runner dengan file konfigurasi minimal, lihat. [Contoh file konfigurasi](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
```

### File konfigurasi Ruby yang diperluas
<a name="service-source-code-ruby.examples.extended"></a>

Contoh ini menunjukkan penggunaan semua kunci konfigurasi dengan runtime terkelola Ruby.

**catatan**  
Versi runtime yang digunakan dalam contoh ini adalah*3.1.2*. Anda dapat menggantinya dengan versi yang ingin Anda gunakan. Untuk versi runtime Ruby terbaru yang didukung, lihat. [Informasi rilis runtime 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"
```

### Sumber aplikasi Ruby lengkap
<a name="service-source-code-ruby.examples.end2end"></a>

Contoh-contoh ini menunjukkan kode sumber untuk aplikasi Ruby lengkap yang dapat Anda gunakan ke layanan runtime 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
```

# Informasi rilis runtime Ruby
<a name="service-source-code-ruby-releases"></a>

**penting**  
App Runner akan mengakhiri dukungan untuk **Ruby 3.1** pada 1 Desember 2025. Untuk rekomendasi dan informasi lebih lanjut, lihat[Akhir dukungan untuk versi runtime terkelola](service-source-code.md#service-source-code.managed-platforms.eos).

Topik ini mencantumkan detail lengkap untuk versi runtime Ruby yang didukung App Runner.


**Versi runtime yang didukung — build App Runner asli**  
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/apprunner/latest/dg/service-source-code-ruby-releases.html)

**catatan**  
App Runner menyediakan proses build yang direvisi untuk runtime utama tertentu yang telah dirilis baru-baru ini. Karena itu, Anda akan melihat referensi ke build *App Runner yang direvisi dan build* *App Runner asli* di bagian tertentu dari dokumen ini. Untuk informasi selengkapnya, lihat [Versi runtime terkelola dan build App Runner](service-source-code.md#service-source-code.build-detail).