Marketplace
Adicione um banco de dados a um app, ou conecte serviços de e-mail, rastreamento de erros, monitoramento, logs, busca, pagamentos e mídia em um passo, pela web, pela CLI ou pelo app de iPhone.
O marketplace reúne em um só catálogo todos os serviços de que um app costuma precisar. Abra Marketplace na barra lateral para navegar por categoria. A lista completa, com logos, está na página de integrações.
Há três tipos de serviço:
- Nos seus servidores: PostgreSQL, MySQL, Redis, MongoDB, ClickHouse, RabbitMQ, Elasticsearch, Memcached, InfluxDB e armazenamento compatível com S3. Conectar um adiciona ao app; ele é criado no servidor do app no próximo deploy, com a string de conexão (por exemplo
DATABASE_URLouREDIS_URL) já definida. Veja Bancos de dados e backups. - Serviços parceiros: Postmark, SendGrid, Mailgun, Resend, Brevo, Sentry, Honeybadger, Bugsnag, Rollbar, AppSignal, New Relic, Scout, Skylight, Algolia, Stripe e Cloudinary. Você cola a chave da sua conta nesse serviço e a Railyard define as variáveis que a biblioteca dele lê, como
SENTRY_DSNouPOSTMARK_API_TOKEN. As chaves ficam no ambiente criptografado do app, junto com suas outras variáveis. - Serviços de logs: Papertrail, Datadog, New Relic Logs, Sumo Logic, Logz.io, Better Stack e Axiom. Conectar um adiciona um drain de logs que envia cada linha do app para ele. Os tokens do Better Stack e do Axiom vão em um cabeçalho
Authorization: Bearere nunca são exibidos de novo. Drains de logs fazem parte do plano Team em diante.
Conectar um serviço nunca remove nada: as outras variáveis, complementos e drains do app continuam como estão.
Pela web
- Abra Marketplace e escolha um serviço. Cada página leva ao cadastro e à documentação do serviço, para você pegar uma chave antes.
- Escolha o app e preencha os campos pedidos. Os campos secretos ficam ocultos enquanto você digita.
- Deixe Refazer deploy agora marcado para o app usar as novas variáveis na hora, ou desmarque para fazer o deploy depois. Drains começam sozinhos, sem deploy.
Admins e donos do time podem conectar serviços.
Pela CLI
railyard marketplace # cada serviço, o tipo e os campos
railyard marketplace --category email
railyard marketplace:connect myapp postmark POSTMARK_API_TOKEN=… --redeploy
railyard marketplace:connect myapp better_stack token=… host=s123456.eu-nbg-2.betterstackdata.com
railyard marketplace:connect myapp addon_redis
Passe cada campo como chave=valor. --redeploy refaz o deploy do app depois de definir as variáveis. Veja a referência da CLI.
No iPhone e iPad
Abra um app e depois Gerenciar → Marketplace. Os serviços ficam agrupados por categoria; toque em Conectar, preencha os campos (opções são seletores, segredos ficam ocultos) e mantenha Refazer deploy agora ligado para aplicar na hora. É preciso um token com permissão de escrita.
Pela API
GET /api/marketplace lista o catálogo, e POST /api/applications/:id/marketplace_connections com {"service": "sentry", "values": {"SENTRY_DSN": "…"}, "redeploy": true} conecta um serviço. Veja a API REST.