

AWS App Runner non sarà più aperto a nuovi clienti a partire dal 30 aprile 2026. Se desideri utilizzare App Runner, registrati prima di tale data. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta [AWS App Runner la pagina Modifica della disponibilità](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html).

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Utilizzo della piattaforma Ruby di
<a name="service-source-code-ruby"></a>

**Importante**  
App Runner interromperà il supporto per **Ruby 3.1** il 1° dicembre 2025. Per consigli e ulteriori informazioni, consulta. [Fine del supporto per le versioni di runtime gestite](service-source-code.md#service-source-code.managed-platforms.eos)

La piattaforma AWS App Runner Ruby fornisce runtime gestiti. Ogni runtime semplifica la creazione e l'esecuzione di contenitori con applicazioni Web basate su una versione di Ruby. Quando si utilizza un runtime Ruby, App Runner si avvia con un'immagine di runtime Ruby gestita. Questa immagine è basata sull'[immagine Docker di Amazon Linux](https://hub.docker.com/_/amazonlinux) e contiene il pacchetto di runtime per una versione di Ruby e alcuni strumenti. App Runner utilizza questa immagine di runtime gestita come immagine di base e aggiunge il codice dell'applicazione per creare un'immagine Docker. Quindi distribuisce questa immagine per eseguire il servizio Web in un contenitore.

 Si specifica un runtime per il servizio App Runner quando si [crea un servizio](manage-create.md) utilizzando la console App Runner o l'[CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)operazione API. Puoi anche specificare un runtime come parte del codice sorgente. Usa la `runtime` parola chiave in un [file di configurazione di App Runner](config-file.md) che includi nel tuo repository di codice. La convenzione di denominazione di un runtime gestito è. *<language-name><major-version>* 

Per i nomi e le versioni di runtime di Ruby validi, vedere. [Informazioni sul rilascio del runtime di Ruby](service-source-code-ruby-releases.md)

App Runner aggiorna il runtime del servizio alla versione più recente a ogni distribuzione o aggiornamento del servizio. Se l'applicazione richiede una versione specifica di un runtime gestito, è possibile specificarla utilizzando la `runtime-version` parola chiave nel file di [configurazione di App Runner](config-file.md). È possibile utilizzare qualsiasi livello di versione, inclusa una versione principale o secondaria. App Runner effettua solo aggiornamenti di livello inferiore al runtime del servizio.

Sintassi della versione per i runtime di Ruby: `major[.minor[.patch]]`

Ad esempio: `3.1.2`

I seguenti esempi mostrano il blocco della versione:
+ `3.1`— Blocca le versioni principali e secondarie. App Runner aggiorna solo le versioni patch.
+ `3.1.2`— Blocca a una versione di patch specifica. App Runner non aggiorna la versione di runtime.

**Topics**
+ [Configurazione del runtime di Ruby](#service-source-code-ruby.config)
+ [Esempi di runtime in Ruby](#service-source-code-ruby.examples)
+ [Informazioni sul rilascio del runtime di Ruby](service-source-code-ruby-releases.md)

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

Quando scegli un runtime gestito, devi anche configurare, come minimo, creare ed eseguire comandi. Li configuri durante la [creazione](manage-create.md) o [l'aggiornamento del](manage-configure.md) servizio App Runner. Puoi farlo utilizzando uno dei seguenti metodi:
+ **Utilizzo della console App Runner**: specifica i comandi nella sezione **Configure build** del processo di creazione o della scheda di configurazione.
+ **Utilizzo dell'API App Runner**: richiama l'operazione [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)or [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)API. Specificate i comandi utilizzando i `StartCommand` membri `BuildCommand` e del tipo di [CodeConfigurationValues](https://docs.aws.amazon.com/apprunner/latest/api/API_CodeConfigurationValues.html)dati.
+ **Utilizzo di un [file di configurazione](config-file.md)**: specifica uno o più comandi di compilazione in un massimo di tre fasi di compilazione e un singolo comando di esecuzione che serve per avviare l'applicazione. Sono disponibili impostazioni di configurazione opzionali aggiuntive.

Fornire un file di configurazione è facoltativo. Quando crei un servizio App Runner utilizzando la console o l'API, specifichi se App Runner ottiene le impostazioni di configurazione direttamente al momento della creazione o da un file di configurazione.

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

Gli esempi seguenti mostrano i file di configurazione di App Runner per la creazione e l'esecuzione di un servizio Ruby. 

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

Questo esempio mostra un file di configurazione minimo che puoi usare con un runtime gestito da Ruby. Per le ipotesi che App Runner fa con un file di configurazione minimo, vedi. [Esempi di file di configurazione](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 di configurazione Ruby esteso
<a name="service-source-code-ruby.examples.extended"></a>

Questo esempio mostra l'uso di tutte le chiavi di configurazione con un runtime gestito da Ruby.

**Nota**  
La versione di runtime utilizzata in questi esempi è*3.1.2*. Puoi sostituirla con una versione che desideri utilizzare. Per l'ultima versione di runtime di Ruby supportata, vedi[Informazioni sul rilascio del runtime di 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"
```

### Fonte completa dell'applicazione Ruby
<a name="service-source-code-ruby.examples.end2end"></a>

Questi esempi mostrano il codice sorgente di un'applicazione Ruby completa che è possibile distribuire su un servizio di 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
```

# Informazioni sul rilascio del runtime di Ruby
<a name="service-source-code-ruby-releases"></a>

**Importante**  
App Runner interromperà il supporto per **Ruby 3.1** il 1° dicembre 2025. Per consigli e ulteriori informazioni, consulta. [Fine del supporto per le versioni di runtime gestite](service-source-code.md#service-source-code.managed-platforms.eos)

Questo argomento elenca i dettagli completi per le versioni di runtime di Ruby supportate da App Runner.


**Versioni di runtime supportate: build originale di App Runner**  
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/apprunner/latest/dg/service-source-code-ruby-releases.html)

**Nota**  
App Runner fornisce un processo di compilazione rivisto per i principali runtime specifici che sono stati rilasciati più di recente. Per questo motivo, in alcune sezioni di questo documento vedrai riferimenti alla build di *App Runner rivista e alla build* *originale di App Runner*. Per ulteriori informazioni, consulta [Versioni di runtime gestite e build di App Runner](service-source-code.md#service-source-code.build-detail).