Distribuzione in produzione delle API Plumber
Containerizzi e distribuisca le API Plumber con Docker e piattaforme cloud
Distribuzione in produzione delle API Plumber è una lezione R Academy gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento R Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso R Academy include 4 lezioni in totale.
Opzioni di deployment in produzione
Un'API Plumber può essere sottoposta a deployment in diversi modi:
- Container Docker — portabile, riproducibile e utilizzabile ovunque
- Posit Connect — deployment con un clic e pianificazione delle esecuzioni
- Digital Ocean / EC2 — una semplice VM Linux con R in esecuzione
Docker è l'opzione più portabile e lo standard del settore per le API R in produzione.
Punto di ingresso dell'API Plumber
Crei un file api.R di primo livello che avvii il server Plumber. Utilizzi Sys.getenv('PORT', unset='8000') per consentire all'orchestratore dei container di impostare la porta senza modificare il codice.
# api.R
# library(plumber)
#
# pr <- plumb('routes.R')
# port <- as.integer(Sys.getenv('PORT', unset = '8000'))
# pr$run(host = '0.0.0.0', port = port)
#
# Listening on 0.0.0.0 is required inside Docker
# (127.0.0.1 is only reachable inside the container)Immagine Docker di base — rocker/r-ver
L'immagine rocker/r-ver fornisce un ambiente R minimale con versione fissata. Fissi sempre una versione specifica di R (ad esempio rocker/r-ver:4.3.2) per garantire build riproducibili. Eviti :latest in produzione.
# Dockerfile
# FROM rocker/r-ver:4.3.2
#
# Alternatively use rocker/plumber which pre-installs plumber:
# FROM rstudio/plumber:latest
#
# rocker/r-ver is more minimal and gives you full control
# over which packages are installed.Installare i pacchetti R nel Dockerfile
Utilizzi RUN Rscript -e "install.packages(...)" per installare i pacchetti durante la build dell'immagine. Installi prima le dipendenze di sistema (ad esempio libssl-dev per httr2) utilizzando apt-get.
# FROM rocker/r-ver:4.3.2
#
# RUN apt-get update && apt-get install -y \
# libssl-dev \
# libcurl4-openssl-dev \
# && rm -rf /var/lib/apt/lists/*
#
# RUN Rscript -e "install.packages(c('plumber', 'jsonlite', 'httr2'), repos='https://cloud.r-project.org')"Copiare i file e impostare la porta
Copi i file sorgente R nel container con COPY. Dichiari la porta con EXPOSE, così Docker sa quale porta il container è in ascolto. Si tratta solo di documentazione: la porta non viene pubblicata.
# FROM rocker/r-ver:4.3.2
# ...
# WORKDIR /app
# COPY routes.R .
# COPY api.R .
#
# EXPOSE 8000
#
# CMD ["Rscript", "api.R"]Creare ed eseguire l'immagine Docker
Crei l'immagine con docker build, quindi esegua un container associando la porta dell'host a quella del container. Il flag -e inietta le variabili d'ambiente contenenti i segreti.
# Build the image:
# docker build -t my-r-api:1.0 .
#
# Run a container:
# docker run -d \
# -p 8000:8000 \
# -e API_SECRET_KEY='my_secret' \
# -e DATABASE_URL='postgres://...' \
# --name r-api \
# my-r-api:1.0
#
# Test:
# curl http://localhost:8000/pingLeggere i segreti con Sys.getenv()
In produzione, non inserisca mai i segreti nel Dockerfile o nel codice sorgente. Li legga a runtime con Sys.getenv(). Li passi tramite i flag Docker -e, i secret di Kubernetes o sistemi di gestione delle variabili d'ambiente come AWS Secrets Manager.
# In routes.R:
# db_url <- Sys.getenv('DATABASE_URL', unset = '')
# api_key <- Sys.getenv('API_SECRET_KEY', unset = '')
#
# if (nchar(db_url) == 0) stop('DATABASE_URL is required')
# if (nchar(api_key) == 0) stop('API_SECRET_KEY is required')
#
# Fail fast at startup rather than failing silently at request time
cat('Validate all required env vars at startup with stop()
')Endpoint di controllo dello stato
Un endpoint /ping o /health consente ai bilanciatori del carico e agli orchestratori (Kubernetes, ECS) di verificare che l'API sia attiva. Dovrebbe restituire rapidamente 200 senza autenticazione e, facoltativamente, controllare la connettività al DB.
# #* Health check
# #* @preempt auth
# #* @get /ping
# function() {
# list(
# status = 'ok',
# version = '1.0.0',
# time = format(Sys.time(), '%Y-%m-%dT%H:%M:%SZ')
# )
# }
#
# Docker HEALTHCHECK:
# HEALTHCHECK CMD curl -f http://localhost:8000/ping || exit 1Esempio completo di Dockerfile
Riuniamo tutti gli elementi: un Dockerfile pronto per la produzione per un'API Plumber:
# FROM rocker/r-ver:4.3.2
# RUN apt-get update && apt-get install -y libssl-dev libcurl4-openssl-dev \
# && rm -rf /var/lib/apt/lists/*
# RUN Rscript -e "install.packages(c('plumber','jsonlite'), repos='https://cloud.r-project.org')"
# WORKDIR /app
# COPY routes.R api.R ./
# EXPOSE 8000
# HEALTHCHECK CMD curl -f http://localhost:8000/ping || exit 1
# CMD ["Rscript", "api.R"]Logging in produzione
Il logging strutturato aiuta a diagnosticare i problemi in produzione. Utilizzi cat() o il pacchetto logger per scrivere log con timestamp su stdout: Docker e la maggior parte delle piattaforme acquisiscono automaticamente stdout e lo inoltrano a un aggregatore di log.
# Log format: ISO timestamp + level + message
log_info <- function(msg) {
cat(format(Sys.time(), '%Y-%m-%dT%H:%M:%S'), '[INFO]', msg, '
')
}
log_info('API starting up')
log_info(paste('Port:', Sys.getenv('PORT', '8000')))Reverse proxy con Nginx
In produzione, posizioni un reverse proxy Nginx davanti a Plumber per gestire la terminazione TLS, la limitazione della frequenza e il buffering delle richieste. Nginx inoltra le richieste a Plumber su localhost, mentre il mondo esterno si connette a Nginx sulla porta 443.
# Nginx config snippet (nginx.conf):
# server {
# listen 443 ssl;
# ssl_certificate /etc/letsencrypt/.../fullchain.pem;
# ssl_certificate_key /etc/letsencrypt/.../privkey.pem;
#
# location /api/ {
# proxy_pass http://127.0.0.1:8000/;
# proxy_set_header Host $host;
# proxy_set_header X-Real-IP $remote_addr;
# }
# }Verifica rapida: Docker EXPOSE
Che cosa fa effettivamente l'istruzione EXPOSE 8000 in un Dockerfile?
Riepilogo del deployment delle API Plumber
Passaggi chiave per il deployment in produzione di Plumber:
- Ascolti su
0.0.0.0e leggaPORTdall'ambiente - Utilizzi
rocker/r-ver:X.Y.Z(con versione fissata) come immagine di base - Installi i pacchetti nel Dockerfile; copi solo i file sorgente
- Inietti i segreti tramite le variabili d'ambiente
-e: mai nel codice sorgente o nel Dockerfile - Aggiunga un endpoint di controllo dello stato
/ping(con#* @preempt auth) - Utilizzi Nginx come reverse proxy per TLS e limitazione della frequenza
Domande Frequenti
La lezione «Distribuzione in produzione delle API Plumber» è gratuita?
Sì — il testo completo di «Distribuzione in produzione delle API Plumber» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso R Academy, passa a CoddyKit PRO. Il corso R Academy include 4 lezioni in totale.
Cosa imparerò in «Distribuzione in produzione delle API Plumber»?
Containerizzi e distribuisca le API Plumber con Docker e piattaforme cloud Eserciti R Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare R Academy?
Non è richiesta alcuna esperienza precedente. R Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.
Quanto tempo richiede la lezione «Distribuzione in produzione delle API Plumber»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione R Academy?
Sì. Ogni lezione R Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Introduzione a Plumber e REST
- Creazione di endpoint GET e POST
- Autenticazione e sicurezza delle API
- Distribuzione in produzione delle API Plumber