PricingLoginStart free
R Academy · Lekcja

Wdrażanie API Plumber na produkcji

Umieszczaj API Plumber w kontenerach i wdrażaj je za pomocą Dockera oraz platform chmurowych.

Lekcja 4 z 413 kroki

Wdrażanie API Plumber na produkcji to bezpłatna lekcja R Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej R Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs R Academy zawiera 4 lekcji w sumie.

Opcje wdrażania produkcyjnego

API Plumbera można wdrożyć na kilka sposobów:

  • Kontener Docker — przenośny, powtarzalny i działający wszędzie
  • Posit Connect — wdrażanie jednym kliknięciem z harmonogramem
  • Digital Ocean / EC2 — zwykła maszyna wirtualna z systemem Linux i językiem R

Docker jest najbardziej przenośną opcją i standardem branżowym w przypadku produkcyjnych interfejsów API w języku R.

Punkt wejścia API Plumbera

Utwórz główny plik api.R, który uruchamia serwer Plumbera. Użyj Sys.getenv('PORT', unset='8000'), aby orkiestrator kontenerów mógł ustawić port bez modyfikowania kodu.

# 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)

Bazowy obraz Dockera — rocker/r-ver

Obraz rocker/r-ver zapewnia minimalne środowisko R z przypiętą wersją. Zawsze przypinaj konkretną wersję R (np. rocker/r-ver:4.3.2), aby zapewnić powtarzalność kompilacji. W środowisku produkcyjnym unikaj :latest.

# 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.

Instalowanie pakietów R w pliku Dockerfile

Użyj RUN Rscript -e "install.packages(...)", aby instalować pakiety podczas budowania obrazu. Najpierw zainstaluj zależności systemowe (np. libssl-dev dla httr2) za pomocą 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')"

Kopiowanie plików i ustawianie portu

Skopiuj pliki źródłowe R do kontenera za pomocą COPY. Zadeklaruj port za pomocą EXPOSE, aby Docker wiedział, na którym porcie kontener nasłuchuje. Jest to tylko dokumentacja — port nie zostaje w ten sposób udostępniony.

# FROM rocker/r-ver:4.3.2
# ...
# WORKDIR /app
# COPY routes.R .
# COPY api.R .
#
# EXPOSE 8000
#
# CMD ["Rscript", "api.R"]

Budowanie i uruchamianie obrazu Dockera

Zbuduj obraz za pomocą docker build, a następnie uruchom kontener, mapując port hosta na port kontenera. Flaga -e wstrzykuje zmienne środowiskowe zawierające sekrety.

# 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/ping

Odczytywanie sekretów za pomocą Sys.getenv()

W środowisku produkcyjnym nigdy nie umieszczaj sekretów w pliku Dockerfile ani w kodzie źródłowym. Odczytuj je w czasie działania za pomocą Sys.getenv(). Przekazuj je za pomocą flag Dockera -e, sekretów Kubernetes lub systemów zarządzania zmiennymi środowiskowymi, takich jak 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 sprawdzania stanu usługi

Endpoint /ping lub /health umożliwia systemom równoważenia obciążenia i orkiestratorom (Kubernetes, ECS) potwierdzenie, że API działa. Powinien szybko zwracać kod 200 bez uwierzytelniania i opcjonalnie sprawdzać połączenie z bazą danych.

# #* 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 1

Kompletny przykład pliku Dockerfile

Połączenie wszystkich elementów — gotowy do użycia w środowisku produkcyjnym plik Dockerfile dla API Plumbera:

# 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"]

Logowanie w środowisku produkcyjnym

Logowanie strukturalne ułatwia diagnozowanie problemów w środowisku produkcyjnym. Użyj cat() lub pakietu logger, aby zapisywać w stdout logi ze znacznikami czasu — Docker i większość platform automatycznie przechwytuje stdout i przekazuje go do agregatora logów.

# 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')))

Odwrotne proxy z Nginx

W środowisku produkcyjnym umieść odwrotne proxy Nginx przed Plumberem, aby obsługiwało terminowanie TLS, ograniczanie częstotliwości żądań i buforowanie żądań. Nginx przekazuje żądania do Plumbera na localhost, a świat zewnętrzny łączy się z Nginx na porcie 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;
#   }
# }

Szybkie sprawdzenie: Docker EXPOSE

Co właściwie robi instrukcja EXPOSE 8000 w pliku Dockerfile?

Odpowiedz w interaktywnej lekcji

Podsumowanie wdrażania API Plumbera

Najważniejsze kroki wdrażania Plumbera w środowisku produkcyjnym:

  • Nasłuchuj na 0.0.0.0 i odczytuj PORT ze środowiska
  • Używaj przypiętego do wersji obrazu bazowego rocker/r-ver:X.Y.Z
  • Instaluj pakiety w pliku Dockerfile; kopiuj tylko pliki źródłowe
  • Wstrzykuj sekrety za pomocą zmiennych środowiskowych -e — nigdy nie umieszczaj ich w kodzie źródłowym ani w pliku Dockerfile
  • Dodaj endpoint /ping sprawdzający stan usługi (z adnotacją #* @preempt auth)
  • Używaj Nginx jako odwrotnego proxy dla TLS i ograniczania częstotliwości żądań
Bezpłatny start

Ucz się R dzięki korepetycjom AI — za darmo

Pisz i uruchamiaj kod w przeglądarce, otrzymuj natychmiastową pomoc od korepetytora AI dostępnego 24/7 i kontynuuj naukę w sieci lub w aplikacji.

Kursy
43
Lekcje
159
Zacznij naukę bezpłatnieWyświetl pełny kurs

Często zadawane pytania

Czy lekcja „Wdrażanie API Plumber na produkcji” jest bezpłatna?

Tak — pełny tekst „Wdrażanie API Plumber na produkcji” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu R Academy, przejdź na CoddyKit PRO. Kurs R Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Wdrażanie API Plumber na produkcji”?

Umieszczaj API Plumber w kontenerach i wdrażaj je za pomocą Dockera oraz platform chmurowych. Ćwiczysz R Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć R Academy?

Nie wymagamy żadnego doświadczenia. R Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.

Ile czasu zajmuje lekcja „Wdrażanie API Plumber na produkcji”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji R Academy?

Tak. Każda lekcja R Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Wprowadzenie do Plumber i REST
  2. Tworzenie endpointów GET i POST
  3. Uwierzytelnianie i bezpieczeństwo API
  4. Wdrażanie API Plumber na produkcji
← Powrót do R Academy