Gói chính thức · Tự động hóa và hạ tầng

Cập nhật issue Jira trực tiếp trên trang của bạn

Ứng dụng Jira Cloud gửi thay đổi của issue và bình luận mới đến kênh của bạn ngay khi chúng xảy ra, để cổng khách hàng, ứng dụng hay màn hình treo tường cập nhật mà không cần polling Jira API.

  • issue-created, issue-updated kèm các trường đã thay đổi, issue-deleted và comment-added, trên jira-{projectKey} và jira-issue-{issueKey}.
  • Hỗ trợ kênh private, danh sách dự án cần gửi, và không gửi tên người trừ khi bạn bật.
  • Xây dựng trên Atlassian Forge: cài đặt và secret được lưu trong Jira, và ứng dụng chỉ kết nối với Jira và cụm Hibira của bạn.
  • Chỉ cần một quy tắc thì không cần ứng dụng: dán URL incoming webhook từ cài đặt ứng dụng vào hành động Send web request của Jira Automation.

Đăng nhập để xem các đoạn mã này với host cụm của riêng bạn. Đăng nhập

  1. Cài đặt

    git clone https://github.com/hibira-io/jira && cd jira
    npm install
    forge register && forge deploy
    forge install --product jira --site your-site.atlassian.net
  2. Thiết lập

    Jira → Settings → Apps → Hibira Realtime
      App ID:  YOUR_APP_ID
      Key:     YOUR_APP_KEY
      Secret:  YOUR_APP_SECRET
      → Save → Send test event
  3. Sử dụng

    const pusher = new Pusher('YOUR_APP_KEY', {
      cluster: 'hkg',
      wsHost: 'ws.hibira.io',
    });
    pusher.subscribe('jira-issue-SUP-42').bind('issue-updated', ({ issue, changes }) => {
      document.querySelector('#status').textContent = issue.status;
    });
  4. Hoặc dùng Jira Automation

    Hibira portal → your app → Settings → Incoming webhook URL
      Channel: jira-SUP   Event: issue-updated   → Create URL
    
    Jira → Project settings → Automation → Create rule
      When: Issue transitioned
      Then: Send web request
        URL:    the incoming webhook URL
                 (add ?pick=issue.key,issue.fields.status.name to send less)
        Method: POST    Body: Issue data

Trước khi bắt đầu

  • Secret của ứng dụng chỉ hiện một lần, khi bạn tạo ứng dụng hoặc xoay vòng secret. Hãy giữ nó trên máy chủ, không bao giờ đưa vào trình duyệt hay bản build game.
  • Với gói Free, hãy thêm mọi origin mà trang của bạn tải từ đó vào Origin được phép của ứng dụng (http://localhost:3000 khi phát triển, sau đó là tên miền của bạn). "*" cần gói trả phí.
  • Forge cần một tài khoản nhà phát triển Atlassian miễn phí và Forge CLI (npm install -g @forge/cli).

Dùng app key từ bảng điều khiển; secret chỉ để trên máy chủ của bạn. Kênh, sự kiện và endpoint xác thực hoạt động y như với Pusher. Tạo tài khoản miễn phí →