0Pricing
R Academy · Aula

Implantando APIs Plumber em produção

Coloque APIs Plumber em contêineres e implante-as com Docker e plataformas de nuvem.

Implantando APIs Plumber em produção é uma aula grátis de R Academy no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de R Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de R Academy inclui 4 aulas no total.

Opções de implantação em produção

Uma API do Plumber pode ser implantada de várias formas:

  • Contêiner Docker — portátil, reproduzível e funciona em qualquer lugar
  • Posit Connect — implantação com um clique e agendamento
  • Digital Ocean / EC2 — uma VM Linux comum executando R

O Docker é a opção mais portátil e o padrão do setor para APIs R em produção.

Ponto de entrada da API do Plumber

Crie um arquivo api.R de nível superior que inicie o servidor do Plumber. Use Sys.getenv('PORT', unset='8000') para que a porta possa ser definida pelo orquestrador de contêineres sem alterar o código.

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

Imagem Docker base — rocker/r-ver

A imagem rocker/r-ver fornece um ambiente R mínimo com a versão fixada. Sempre fixe uma versão específica do R (por exemplo, rocker/r-ver:4.3.2) para garantir compilações reproduzíveis. Evite :latest em produção.

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

Instalando pacotes do R no Dockerfile

Use RUN Rscript -e "install.packages(...)" para instalar pacotes durante a compilação da imagem. Instale primeiro as dependências do sistema (por exemplo, libssl-dev para httr2) usando 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')"

Copiando arquivos e definindo a porta

Copie seus arquivos de código-fonte do R para o contêiner com COPY. Declare a porta com EXPOSE para que o Docker saiba em qual porta o contêiner escuta. Isso serve apenas como documentação — não publica a porta.

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

Compilando e executando a imagem Docker

Compile a imagem com docker build e depois execute um contêiner mapeando a porta do host para a porta do contêiner. A opção -e injeta variáveis de ambiente para os segredos.

# 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

Lendo segredos com Sys.getenv()

Em produção, nunca coloque segredos no Dockerfile ou no código-fonte. Leia-os em tempo de execução com Sys.getenv(). Passe-os por meio das opções -e do Docker, dos segredos do Kubernetes ou de sistemas de gerenciamento de variáveis de ambiente, como o 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 de verificação de integridade

Um endpoint /ping ou /health permite que balanceadores de carga e orquestradores (Kubernetes, ECS) confirmem que a API está ativa. Ele deve retornar 200 rapidamente, sem autenticação, e pode opcionalmente verificar a conectividade com o banco de dados.

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

Exemplo completo de Dockerfile

Reunindo tudo — um Dockerfile pronto para produção para uma API do 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"]

Registro de eventos em produção

O registro estruturado de eventos ajuda a diagnosticar problemas em produção. Use cat() ou o pacote logger para gravar registros com marcação de tempo em stdout — o Docker e a maioria das plataformas capturam stdout automaticamente e o encaminham para um agregador de registros.

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

Proxy reverso com Nginx

Em produção, coloque um proxy reverso Nginx na frente do Plumber para lidar com o encerramento do TLS, a limitação de taxa e o armazenamento em buffer das solicitações. O Nginx encaminha as solicitações ao Plumber no localhost, enquanto o mundo externo se conecta ao Nginx na 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ção rápida: Docker EXPOSE

O que a instrução EXPOSE 8000 em um Dockerfile realmente faz?

Recapitulação da implantação de APIs do Plumber

Etapas principais para implantar o Plumber em produção:

  • Escute em 0.0.0.0 e leia PORT do ambiente
  • Use rocker/r-ver:X.Y.Z (com a versão fixada) como imagem base
  • Instale os pacotes no Dockerfile; copie apenas os arquivos de código-fonte
  • Injete os segredos por meio de variáveis de ambiente -e — nunca no código-fonte ou no Dockerfile
  • Adicione um endpoint de verificação /ping (com #* @preempt auth)
  • Use o Nginx como proxy reverso para TLS e limitação de taxa

Perguntas Frequentes

A aula “Implantando APIs Plumber em produção” é grátis?

Sim — o texto completo de “Implantando APIs Plumber em produção” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de R Academy, atualize para CoddyKit PRO. O curso de R Academy inclui 4 aulas no total.

O que vou aprender em “Implantando APIs Plumber em produção”?

Coloque APIs Plumber em contêineres e implante-as com Docker e plataformas de nuvem. Você pratica R Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar R Academy?

Nenhuma experiência prévia é necessária. R Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.

Quanto tempo leva a aula “Implantando APIs Plumber em produção”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de R Academy?

Sim. Cada aula de R Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. Introdução ao Plumber e REST
  2. Criando endpoints GET e POST
  3. Autenticação e segurança de APIs
  4. Implantando APIs Plumber em produção
← Voltar para R Academy