quipu/code
Guía10 min

Guía de Atlassian Forge para principiantes: de cero a tu primer app

Atlassian Forge es el runtime serverless oficial para construir apps en Jira y Confluence. En esta guía instalamos el CLI, creamos un 'Hello World' y desplegamos en la nube de Atlassian.

QuipuCode Team

Atlassian Forge es la plataforma de desarrollo oficial para construir aplicaciones que se ejecutan dentro de la infraestructura de Atlassian. Sin servidores propios, sin gestión de credenciales OAuth, sin proxies. Tu código vive y escala junto al producto.

Requisitos previos

  • Node.js ≥ 18
  • Una cuenta gratuita en developer.atlassian.com
  • Un sitio de desarrollo de Jira/Confluence (gratuito)

Instalación del CLI

bash
npm install -g @forge/cli

# Verificar instalación
forge --version
# forge/10.x.x

# Autenticarse con tu cuenta de Atlassian
forge login

Crear tu primer proyecto

bash
forge create

# Sigue el wizard:
# ? Nombre del proyecto: › mi-primera-app
# ? Selecciona una categoría: › Jira
# ? Selecciona un template: › Jira Issue Panel - Custom UI

Esto genera la siguiente estructura:

plaintext
mi-primera-app/
├── manifest.yml        ← Declaración de módulos y permisos
├── forge/
│   └── src/
│       └── index.tsx   ← Entry point del backend Forge
└── static/
    └── hello-world/    ← App React (Custom UI)
        ├── src/
        └── package.json

El fichero manifest.yml

Este es el corazón de tu app. Define qué módulos activas y qué permisos solicitas:

yaml
modules:
  jira:issuePanel:
    - key: my-panel
      title: Mi Panel
      layout: basic
      resource: main
      resolver:
        function: resolver

resources:
  - key: main
    path: static/hello-world/build

function:
  - key: resolver
    handler: index.handler

permissions:
  scopes:
    - read:jira-work
    - write:jira-work

Desplegar y probar

bash
# Desplegar en el entorno de desarrollo
forge deploy

# Instalar en tu sitio de desarrollo
forge install --site tu-sitio.atlassian.net --product jira

# Ver logs en tiempo real
forge tunnel

Con forge tunnel activas un túnel que redirige las invocaciones al runtime de Forge hacia tu máquina local. Ideal para desarrollo rápido con hot-reload.

Próximos pasos

  • Aprende sobre el ADF (Atlassian Document Format) para manipular contenido rich text
  • Explora los Storage API para persistir datos sin base de datos propia
  • Revisa la sección de UI Kit 2 para componentes nativos de Atlassian Design System

Seguiremos publicando guías técnicas de Forge. Suscríbete a la lista de espera para no perderte nada.