Udrulning af Plumber-API'er i produktion
Containerisér og udrul Plumber-API'er med Docker og cloud-platforme.
Udrulning af Plumber-API'er i produktion er en gratis R Academy-lektion på CoddyKit. Dette er lektion 4 af 4. Du kan læse alle 3 lektioner i dette læringsspor gratis i deres fulde længde — derefter låser CoddyKit PRO alle lektioner op samt praktiske øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Den er en del af læringsforløbet i R Academy, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. R Academy-kurset indeholder 4 lektioner i alt.
Muligheder for udrulning i produktion
En Plumber-API kan udrulles på flere måder:
- Docker-container – portabel, reproducerbar og fungerer overalt
- Posit Connect – udrulning med et tryk på en knap og planlægning
- Digital Ocean / EC2 – en almindelig Linux-VM, der kører R
Docker er den mest portable løsning og branchestandarden for R-API'er i produktion.
Plumber API-startpunkt
Opret en api.R på øverste niveau, som starter Plumber-serveren. Brug Sys.getenv('PORT', unset='8000'), så containerorkestratoren kan angive porten uden ændringer i koden.
# 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)Grundlæggende Docker-image – rocker/r-ver
Imaget rocker/r-ver indeholder et minimalt R-miljø med fastlåst version. Fastlås altid en bestemt R-version, f.eks. rocker/r-ver:4.3.2, for at sikre reproducerbare builds. Undgå :latest i produktion.
# 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.Installation af R-pakker i Dockerfile
Brug RUN Rscript -e "install.packages(...)" til at installere pakker under opbygningen af imaget. Installér systemafhængigheder først, f.eks. libssl-dev til httr2, ved hjælp af 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')"Kopiering af filer og angivelse af porten
Kopiér dine R-kildefiler ind i containeren med COPY. Erklær porten med EXPOSE, så Docker ved, hvilken port containeren lytter på. Dette er kun dokumentation – porten bliver ikke gjort offentligt tilgængelig.
# FROM rocker/r-ver:4.3.2
# ...
# WORKDIR /app
# COPY routes.R .
# COPY api.R .
#
# EXPOSE 8000
#
# CMD ["Rscript", "api.R"]Opbygning og kørsel af Docker-imaget
Opbyg imaget med docker build, og kør derefter en container, der knytter værtens port til containerens port. Flaget -e indsætter miljøvariabler til hemmeligheder.
# 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/pingLæsning af hemmeligheder med Sys.getenv()
I produktion må du aldrig placere hemmeligheder i Dockerfile eller kildekoden. Læs dem ved kørsel med Sys.getenv(). Send dem via Docker-flagene -e, Kubernetes-hemmeligheder eller systemer til håndtering af miljøvariabler som 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()
')Slutpunkt til sundhedstjek
Et /ping- eller /health-slutpunkt lader load balancere og orkestratorer (Kubernetes, ECS) bekræfte, at API'en er aktiv. Det bør hurtigt returnere 200 uden godkendelse og kan eventuelt kontrollere databaseforbindelsen.
# #* 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 1Komplet Dockerfile-eksempel
Her samles det hele – en produktionsklar Dockerfile til en Plumber-API:
# 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"]Logning i produktion
Struktureret logning hjælper med at diagnosticere problemer i produktion. Brug cat() eller pakken logger til at skrive logfiler med tidsstempler til stdout – Docker og de fleste platforme opfanger automatisk stdout og sender det videre til en logindsamler.
# 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 med Nginx
I produktion skal du placere en Nginx reverse proxy foran Plumber for at håndtere TLS-terminering, hastighedsbegrænsning og buffering af forespørgsler. Nginx videresender forespørgsler til Plumber på localhost, mens omverdenen opretter forbindelse til Nginx på port 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;
# }
# }Hurtigt tjek: Docker EXPOSE
Hvad gør instruktionen EXPOSE 8000 i en Dockerfile egentlig?
Opsamling på udrulning af Plumber-API'er
Vigtige trin ved udrulning af Plumber i produktion:
- Lyt på
0.0.0.0, og læsPORTfra miljøet - Brug
rocker/r-ver:X.Y.Z(med fastlåst version) som grundimage - Installér pakker i Dockerfile, og kopiér kun kildefiler
- Indsæt hemmeligheder via miljøvariabler med
-e– aldrig i kildekode eller Dockerfile - Tilføj et
/ping-slutpunkt til sundhedstjek (med#* @preempt auth) - Brug Nginx som reverse proxy til TLS og hastighedsbegrænsning
Lær R med en AI-underviser — gratis
Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.
- Kurser
- 43
- Lektioner
- 159
Ofte stillede spørgsmål
Er lektionen “Udrulning af Plumber-API'er i produktion” gratis?
Ja — alle 3 lektioner i læringssporet R Academy, inklusive “Udrulning af Plumber-API'er i produktion”, kan læses gratis i deres fulde længde her på webstedet. Derefter låser CoddyKit PRO alle lektioner op samt interaktive øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. R Academy-kurset indeholder 4 lektioner i alt.
Hvad lærer jeg i “Udrulning af Plumber-API'er i produktion”?
Containerisér og udrul Plumber-API'er med Docker og cloud-platforme. Du øver dig i R Academy med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.
Skal jeg have erfaring for at begynde på R Academy?
Der kræves ingen tidligere erfaring. R Academy på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 4 af 4.
Hvor lang tid tager lektionen “Udrulning af Plumber-API'er i produktion”?
De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.
Kan jeg skrive og køre kode i denne R Academy-lektion?
Ja. Alle R Academy-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.
Alle lektioner i dette kursus
- Introduktion til Plumber og REST
- Oprettelse af GET- og POST-endpoints
- Godkendelse og API-sikkerhed
- Udrulning af Plumber-API'er i produktion