Hướng dẫn cài đặt và sử dụng cơ bản JIRA (JIRA software, JIRA core) trên windows

Cài đặt JIRA trên Windows

Trong hướng dẫn này, chúng tôi sẽ giới thiệu cho bạn cách cài đặt JIRA trên Windows với một cơ sở dữ liệu.

Sau đây là cách tốt nhất để cài đặt và thiết lập trên một Windows server

Trước khi bắt đầu cài đặt

Trước khi cài đặt JIRA, bạn cần nắm vững một số lý thuyết sau

Bạn đang sử dụng một hệ điều hành được hỗ trợ?
Kiểm tra các nền tảng hỗ trợ phù hợp với phiên bản ứng dụng JIRA dự định cài đặt. Điều này sẽ cung cấp cho bạn thông tin về hệ điều hành được hỗ trợ, cơ sở dữ liệu và trình duyệt.
Lưu ý:
  • Chúng tôi không hỗ trợ cài đặt  trên OSX hoặc mac OS.
  • Trình cài đặt đã bao gồm Java (JRE) và Tomcat, vì vậy bạn không cần phải cài đặt riêng.
Bạn có muốn chạy JIRA như một Windows Service?

Chạy ứng dụng cài đặt như một service trong Windows có nghĩa là ứng dụng JIRA của bạn sẽ tự động khởi động kèm theo Windows khởi động.

Nếu bạn muốn chạy ứng dụng như một service:

  • Bạn phải đăng nhập vào vai trò quản trị viên để chạy trình cài đặt.
  • Ứng dụng sẽ chạy như là Windows 'SYSTEM' của tài khoản người dùng.
  • Chúng tôi thực sự khuyên bạn nên tạo một tài khoản người dùng chuyên dụng (ví dụ với tên người dùng 'jira') trên Windows để chạy ứng dụng

Nếu bạn không muốn chạy ứng dụng như một service:

  • Bạn bắt đầu cài đặt và dừng lại ứng dụng JIRA bằng cách chạy tập tin start-jira.bat trong thư mục cài đặt.
  • Ứng dụng JIRA sẽ được chạy bằng tài khoản người dùng Windows đã sử dụng để cài đặt JIRA, hoặc bạn có thể chọn tài khoản người dùng chuyên dụng để chạy ứng dụng.
  • JIRA sẽ cần phải khởi động lại thủ công nếu server của bạn được khởi động lại.
Bạn đã thiết lập cơ sở dữ liệu cho ứng dụng?
Để chạy ứng dụng JIRA, bạn cần phải kết nối với cơ sở dữ liệu. Kiểm tra các nền tảng hỗ trợ cho phiên bản ứng dụng cài đặt, để nắm danh sách các cơ sở dữ liệu mà JIRA hiện đang hỗ trợ. Nếu bạn chưa có cơ sở dữ liệu, thì có thể tham khảo PostgreSQL, ứng dụng miễn phí, dễ cài đặt và đã được thử nghiệm rộng rãi với ứng dụng JIRA

Lưu ý:

  • Thiết lập cơ sở dữ liệu trước khi bắt đầu cài đặt ứng dụng JIRA. PostgreSQL, Oracle, MySQL và SQL Server đều có sẵn hướng dẫn cài đặt .
  • Sử dụng mã hoá ký tự UTF-8.
  • Nếu bạn đang sử dụng Oracle hoặc MySQL bạn cần tải về driver cho cơ sở dữ liệu của bạn.
  • Cơ sở dữ liệu H2 được nhúng có thể được sử dụng để đánh giá ứng dụng, nhưng bạn sẽ cần phải chuyển chúng sang cơ sở dữ liệu khác trước khi chạy ứng dụng. Bạn có thể dễ dàng sử dụng cơ sở dữ liệu bên ngoài ngay từ đầu.


Bạn có giấy phép bản quyền?

Bạn cần một phải có giấy pháp bản quyền sử dụng ứng dụng JIRA

Lưu ý:

  • Nếu bạn chưa mua một giấy phép bản quyền, bạn sẽ có thể tạo một bản dùng thử trong quá trình thiết lập.
  • Ngược lại nếu bạn đã có giấy phép bản quyền sử dụng, bạn có thể nhập vào trong quá trình thiết lập.
  • Nếu bạn đang di chuyển từ ứng dụng trên cloud sang server, bạn sẽ cần một giấy phép mới.

Cài đặt ứng dụng JIRA

1. Tải về gói ứng dụng JIRA

Candylio cung cấp gói cài đặt cho JIRA

2. Cài đặt

  1. Chạy cài đặt. Chúng tôi khuyên bạn nên sử dụng tài khoản quản trị viên trên Windows
  2. Làm theo hướng dẫn để cài đặt. Bạn sẽ được yêu cầu cung cấp các thông tin sau:
     
    1.  Destination directory – nơi ứng dụng được cài đặt
    2.  Home directory – đây là nơi mà dữ liệu ứng dụng như nhật ký, chỉ mục tìm kiếm và tập tin sẽ được lưu trữ.
    3.  TCP ports – đây là cổng kết nối HTTP và cổng điều khiển ứng dụng sẽ chạy.Luôn được gán mặc định trừ khi bạn đang chạy một ứng dụng khác trên cùng một cổng.
    4. Install as service – tùy chọn này chỉ có sẵn nếu bạn chạy trình cài đặt với tư cách quản trị viên.
  3. Ứng dụng sẽ xuất hiện trong trình duyệt web của bạn sau khi quá trình cài đặt hoàn tất.

Cài đặt ứng dụng JIRA

3.Chọn tùy chỉnh cài đặt


Tùy vào lựa chọn của bạn, có thể cài đặt trọn bộ ứng dụng, cài đặt từng phần hoặc nâng cấp ứng dụng


4. Kết nối đến cơ sở dữ liệu


  1. Nếu bạn chưa làm như vậy, đã đến lúc tạo cơ sở dữ liệu cho bạn. Xem lại phần 'Trước khi bắt đầu cài đặt' để biết thêm thông tin chi tiết
  2. Chọn cơ sở dữ liệu 
  3. Chọn loại cơ sở dữ liệu rồi nhập các chi tiết cho cơ sở dữ liệu của bạn.
      

    Ứng dụng kết nối đến cơ sở dữ liệu của bạn bằng cách sử dụng kết nối cơ sở dữ liệu theo tiêu chuẩn JDBC. Kết nối tổng hợp được xử lý bên trong, bạn có thể thay đổi điều này bằng cách cấu hình công cụ ứng dụng.

    Nếu bạn đang sử dụng MySQL có thêm một bước:

    • Tải về và giải nén cơ sở dữ liệu JDBC Driver thích hợp.
    • Kéo thả tập tin JAR vào danh mục cài đặt (ví dụ với Jira là  <jira-installation>/lib ) trước khi tiếp tục với các hướng dẫn cài đặt.

    Trong hướng dẫn cài đặt:

    • Driver Class Name – tên lớp Java cho driver cơ sở dữ liệu của bạn. Nếu bạn không chắc chắn, kiểm tra lại tài liệu cho cơ sở dữ liệu của bạn.
    • Database URL – URL JDBC cho cơ sở dữ liệu của bạn. Nếu bạn không chắc chắn, kiểm tra lại tài liệu cho cơ sở dữ liệu của bạn.
    • Username  Password – Phải sử dụng tên người dùng và mật khẩu hợp lệ để truy cập vào cơ sở dữ liệu của bạn.

5. Thiết lập thuộc tính ứng dụng


  1. Tạo tên trang ứng dụng
  2. Tùy chỉnh trang ứng dụng riêng tư hay bất kỳ ai cũng có thể đăng ký. Bạn có thể thay đổi điều này sau.
  3. Tạo URL của bạn - đây là địa chỉ mà mọi người sử dụng để truy cập vào trang web của ứng dụng

6. Nhập giấy phép bản quyền


Liên hệ Candylio để có được giấy phép bản quyền


7. Tạo tài khoản quản trị viên

Nhập chi tiết cho tài khoản quản trị viên. Bạn có thể thêm nhiều quản trị viên sau khi thiết lập xong.

8. Thiết lập thông báo email

Nhập chi tiết của mail server. Nó cho phép ứng dụng JIRA gửi thông báo tới email người dùng khi có sự thay đổi (ví dụ công việc hoàn thành, công việc do ai thực hiện...)

9. Bắt đầu sử dụng JIRA


Sau khi hoàn thành trang web ứng dụng của bạn có thể được truy cập từ URL cơ sở của bạn hoặc URL như sau: http: // <computer_name_or_IP_address>: <port>
Đây là một vài điều bạn cần thiết lập trước tiên
  • Thêm và mời người dùng vào nhóm của bạn hoặc định cấu hình danh mục người dùng cho các nhóm lớn hơn.
  • Tạo dự án đầu tiên của bạn để bắt đầu công việc.
  • Cấu hình SSL hoặc HTTPS để giữ cho ứng dụng an toàn hơn.

Xử lý sự cố

Một số công cụ chống vi rút hoặc các công cụ bảo mật Internet khác có thể gây trở ngại cho quá trình cài đặt ứng dụng và ngăn cản quá trình hoàn thành. Nếu bạn gặp sự cố với các công cụ chống vi rút / bảo mật Internet của mình, hãy tắt công cụ này trước khi tiếp tục cài đặt.




Sử dụng Jira

Tìm kiếm công việc của bạn (issue)

Thông thường, Người quản lý sẽ tạo ra một dự án Scrum hoặc Kanban và đưa các dữ liệu tồn đọng vào các vấn đề. Có một số cách để điều hướng xung quanh dự án của bạn, nhưng cách dễ nhất để xem thông tin là bằng cách sử dụng bảng. Một bảng hiển thị các vấn đề từ một hoặc nhiều dự án - nó cung cấp cho bạn một cách linh hoạt để xem, quản lý và xem lại công việc của bạn. Trong bước này, chúng tôi mô tả cách bạn sẽ tìm thấy một vấn đề để làm việc, trong cuộc chạy nước rút tích cực của hội đồng quản trị của một dự án Scrum.

  1. Chọn Boards từ danh mục ở trên, sau đó chọn một bảng từ danh sách kéo xuống
  2. Chọn Active sprints để xem có các công việc có trong một sprint
  3. Các công việc được đại diện bởi các issue cards trong Active sprints của bảng.Các card sẽ hiển thị nhanh các thông tin cần thiết như tên công việc, mã (key) công việc, người được giao việc và mô tả. Di chuyển các card từ cột To do sang In Progress để bắt đầu thực hiện một công việc mà bạn được giao


Làm việc với các issue



Bằng cách di chuyển một issue đến In Progress, công việc đó sẽ được bắt đầu từ thời điểm đó. Ở giai đoạn này, bạn sẽ cần phải gán nó cho chính mình, để mọi người biết ai đang làm việc trên nó. Bạn cũng có thể muốn thêm một số chi tiết kỹ thuật về vấn đề này - bạn bè của bạn cần biết càng nhiều thông tin càng tốt về những vấn đề mà bạn đang làm việc.

  1. Trong Active sprints của bảng, chọn công việc trong cột In Progress. Issue card sẽ hiển thị thông tin chi tiết về công việc đó
  2. Trong phần xem thông tin chi tiết công việc, chọn Edit trong thiết lập. Hộp thoại Edit Issue sẽ hiển thị.
  3. Nếu công việc đó chưa được gán cho bạn, gõ tên bạn vào trong trường (field) Assignee.
  4. Thêm vài thông tin kỹ thuật cho công việc nếu cần thiết.
    Lưu ý, bạn có thể cần một vài thành phần (component) hoặc phiên bản (version) cụ thể cho công việc, nếu bạn đã cấu hình component và version cho dự án. Ngoài ra bạn cũng có thể đính kèm các tập tin quan trọng.
  5. Khi bạn đã hoàn thành việc cập nhật thông tin, bấm vào nút Update.

Cộng tác trong đội

Trong khi bạn đang thực hiện một công việc, bạn có thể cần một vài thông tin chia sẻ, làm sáng tỏ thông tin, hoặc thảo luận một số thứ với các đồng đội. Cộng tác dễ dàng hơn với các bình luận trên công việc.

  1. Chọn một công việc để thêm bình luận.
  2. Trong phần xem thông tin chi tiết, bấm vào nút Comment
  3. Trong phần văn bản của Comment, gõ bình luận của bạn. 
  4. Để email tới các người dùng khác về bình luận của bạn, đơn giản là sử dụng '@tên người dùng khác' trong phần bình luận và email sẽ được gửi tới người dùng đó (đã đăng ký tài khoản JIRA).
  5. Bấm vào nút Add để lưu lại bình luận.

Tạo một branch

Sau khi tự gán công việc cho chính mình và nhập thông tin chi tiết kỹ thuật, bạn đã sẵn sàng thực hiện việc coding (lập trình code). Lời khuyên cho bạn là nên tạo một branch khi bạn bắt đầu thực hiện công việc. Bằng cách này, bạn sẽ có luồng công việc riêng của mình mà không can thiệp vào công việc còn lại của nhóm. Nó cũng đảm bảo rằng các thay đổi của bạn được xem xét trước khi được sáp nhập lại vào branch chính.

JIRA Software có thể liên kết một code hosting hoặc một nguồn quản lý code, như Bitbucket Cloud hoặc Bitbucket Server. Điều này cho phép bạn cộng tác và quản lý mã nguồn trực tiếp từ bên trong JIRA. Tích hợp một ứng dụng cho phép bạn và đội của bạn tạo một branch trực tiếp từ một công việc, giúp quy trình làm việc của bạn nhanh hơn từ việc lựa chọn một công việc để coding

Trước khi tạo một branch, bạn nên biết cách sử dụng các branch trong kho lưu trữ nguồn mà đội của bạn đang sử dụng

  1. Chọn công việc mà bạn muốn tạo branch.
  2. Trong phần thông tin công việc, đi đến bảng Development và bấm Create branch. Hộp thoại tạo branch sẽ xuất hiện.
  3. Bao gồm mã công việc (issue key) trong tên branch. Nếu bạn cài đặt kích hoạt quy trình làm việc, trạng thái của công việc có thể tự động chuyển sang 'In progress'.
  4. Nhập vào các thông tin cần thiết khác cho branch.
  5. Bấm nút Create branch. Branch của bạn sẽ được tạo trong nguồn kho lưu trữ.

Bắt đầu coding

Bây giờ bạn đã tạo một branch mới, bạn có thể bắt đầu công việc coding mà không phải lo lắng về những thay đổi có thể ảnh hưởng đến branch chủ. Hãy đảm bảo rằng các Key issue tham khảo cũng được thêm vào issue mà bạn đang thực hiện, khi đó các công cụ phát triển đã được kết nối cũng sẽ được liên kết tới các công việc có liên quan.

  1. Đi tới kho lưu trữ nguồn, nơi tạo branch mới và truy cập vào branch đó.
  2. Trong branch mới, thực thi code hoặc sửa lỗi khi cần thiết.

Xem xét lại công việc

Sử dụng Pull requests để thông báo đến đồng đội về những thay đổi trong kho lưu trữ của bạn. Kể từ khi Pull request được gửi, đồng đội của bạn có thể xem xét, thảo luận về những thay đổi hoặc thay thế các Commits theo đó.

  1. Bấm branches trong bảng Development để mở hộp thoại hiển thị các branch được liên kết trong Software Configuration Manager (SCM). Nếu JIRA Software được liên kết với nhiều hơn một SCM, một tab sẽ hiển thị mỗi ứng dụng SCM application (ví dụ Bitbucket Server). Các branches sẽ được nhóm theo mỗi SCM trong những tab đó.



  2. Nhấp vào một kho lưu trữ hoặc branch để mở SCM được liên kết tại kho hoặc branch có liên quan.
  3. Di chuyển qua trạng thái Pull request (ví dụ MERGED) để hiện thị các liên kết được yêu cầu pull request
  4. Bấm Create pull request để tạo một pull request cho branch.

Hoàn thành công việc

Sau khi công việc đã được xem xét và sáp nhập với branch chủ, bước cuối cùng là đóng công việc lại

  1. Tìm đến vị trị card công việc trong Active sprints của bảng.
  2. Kéo và thả card đó vào cột Done. Nếu bạn đã cấu hình quy trình công việc, trạng thái công việc sẽ tự động chuyển sang 'Close'.
  3. Chọn Resolution cho công việc đó từ trình kéo xuống.



  4. Cung cấp các thông tin cần thiết
  5. Chọn Close Issue.