Railway Templates

Railway Templates

Procure e implante serviços do marketplace de templates do Railway.

Quando Usar

• Usuário pede para "adicionar Postgres", "adicionar Redis", "adicionar um banco de dados"
• Usuário pede para "adicionar Ghost", "adicionar Strapi", "adicionar n8n", ou qualquer outro serviço
• Usuário quer encontrar templates para um caso de uso (ex: "CMS", "storage", "monitoramento")
• Usuário pergunta "quais templates estão disponíveis?"
• Usuário quer implantar um serviço pré-configurado

Códigos de Template Comuns

Para outros templates, use a consulta de busca abaixo.

Pré-requisitos

Obtenha contexto do projeto:

railway status --json

Extraia:

• id - ID do projeto
• environments.edges[0].node.id - ID do ambiente

Obtenha ID do workspace:

bash <<'SCRIPT'
${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \
  'query getWorkspace($projectId: String!) {
    project(id: $projectId) { workspaceId }
  }' \
  '{"projectId": "PROJECT_ID"}'
SCRIPT

Procurar Templates

Liste templates disponíveis com filtros opcionais:

bash <<'SCRIPT'
${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \
  'query templates($first: Int, $verified: Boolean) {
    templates(first: $first, verified: $verified) {
      edges {
        node {
          name
          code
          description
          category
        }
      }
    }
  }' \
  '{"first": 20, "verified": true}'
SCRIPT

Argumentos

Limite de Taxa

10 requisições por minuto. Não faça buscas em excesso.

Obter Detalhes do Template

Busque um template específico por código:

bash <<'SCRIPT'
${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \
  'query template($code: String!) {
    template(code: $code) {
      id
      name
      description
      serializedConfig
    }
  }' \
  '{"code": "postgres"}'
SCRIPT

Retorna:

• id - ID do template (necessário para implantação)
• serializedConfig - configuração do serviço (necessária para implantação)

Implantar Template

Passo 1: Buscar Template

bash <<'SCRIPT'
${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \
  'query template($code: String!) {
    template(code: $code) {
      id
      serializedConfig
    }
  }' \
  '{"code": "postgres"}'
SCRIPT

Passo 2: Implantar no Projeto

bash <<'SCRIPT'
${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh \
  'mutation deployTemplate($input: TemplateDeployV2Input!) {
    templateDeployV2(input: $input) {
      projectId
      workflowId
    }
  }' \
  '{
    "input": {
      "templateId": "TEMPLATE_ID_FROM_STEP_1",
      "serializedConfig": SERIALIZED_CONFIG_FROM_STEP_1,
      "projectId": "PROJECT_ID",
      "environmentId": "ENVIRONMENT_ID",
      "workspaceId": "WORKSPACE_ID"
    }
  }'
SCRIPT

Importante: serializedConfig é o objeto JSON exato da consulta de template, não uma string.

Composição

• Conectar serviços: Use a skill railway-environment para adicionar referências de variáveis
• Ver serviço implantado: Use a skill railway-service
• Verificar logs: Use a skill railway-deployment
• Adicionar domínios: Use a skill railway-domain