1. Thông tin hệ thống

Server hiện tại

• Hệ điều hành: Ubuntu 24.04
• Bitbucket: 8.3.0
• Database: Oracle 19c
• Domain: bit.tmg.com

Server mới

• Hệ điều hành: Ubuntu 24.04
• Bitbucket: 8.3.0 (cùng phiên bản với server cũ)
• Database: Oracle 19c
• Domain: bit.eq.vn

Mục tiêu

Di chuyển toàn bộ dữ liệu Bitbucket từ server cũ sang server mới, bao gồm:

• Repository Git
• Project
• User
• Permission
• Pull Request
• Plugin
• Attachment
• Cấu hình hệ thống

Bước 1. Chuẩn bị server mới

• Cài đặt Ubuntu 24.04
• Cài Bitbucket Server 8.3.0
• Cài Oracle 19c
• Không cần hoàn tất bước cấu hình Bitbucket (không cần kết nối Database tại giao diện Setup Wizard).

Lưu ý:

Bitbucket 8.3.0 chỉ hỗ trợ Git từ 2.31.x đến 2.38.x.

Kiểm tra phiên bản Git:

git --version

Nếu Git lớn hơn 2.38.x (ví dụ 2.43.0 trên Ubuntu 24.04) thì cần hạ phiên bản Git trước khi khởi động Bitbucket.

Bước 2. Dừng Bitbucket trên server cũ

service atlbitbucket stop

Kiểm tra đảm bảo không còn tiến trình Bitbucket:

ps -ef | grep bitbucket

Bước 3. Sao chép Bitbucket Home

Copy toàn bộ thư mục Bitbucket Home từ server cũ sang server mới:

rsync -avz --progress \
/var/atlassian/application-data/bitbucket/ \
[email protected]:/var/atlassian/application-data/bitbucket/

Sau khi copy xong, cập nhật quyền:

chown -R atlbitbucket:atlbitbucket \
/var/atlassian/application-data/bitbucket

Bước 4. Chuyển dữ liệu Oracle

Trên Oracle Server cũ

Export toàn bộ schema Bitbucket bằng Data Pump:

expdp ...

Trên Oracle Server mới

Import lại schema:

impdp ...

Sau khi import hoàn tất, kiểm tra các object đều ở trạng thái VALID.

Bước 5. Cập nhật cấu hình Database

Chỉnh sửa file:

/var/atlassian/application-data/bitbucket/shared/bitbucket.properties

Cập nhật lại thông tin kết nối Oracle:

jdbc.driver=oracle.jdbc.OracleDriver
jdbc.url=jdbc:oracle:thin:@<oracle-host>:1521/<service_name>
jdbc.user=<username>
jdbc.password=<password>

Nếu Oracle SID hoặc Service Name thay đổi thì cập nhật tương ứng.

Bước 6. Cập nhật Base URL

Sau khi Bitbucket hoạt động, đăng nhập với tài khoản quản trị:

Administration → Server settings

Đổi:

Base URL

từ:

https://bit.tmg.com

thành:

https://bit.eq.vn

Bước 7. Khởi động Bitbucket

systemctl start atlbitbucket

Hoặc:

service atlbitbucket start

Kiểm tra trạng thái:

systemctl status atlbitbucket

Theo dõi log:

tail -f /var/atlassian/application-data/bitbucket/log/atlassian-bitbucket.log

Bước 8. Kiểm tra sau khi chuyển

• Truy cập giao diện Bitbucket.
• Đăng nhập bằng tài khoản quản trị.
• Kiểm tra:
  • Project
  • Repository
  • User
  • Permission
  • Pull Request
  • Webhook
  • Plugin
  • SSH Clone
  • HTTP Clone
• Thực hiện thử:
  • Git Clone
  • Git Push
  • Git Pull

Lưu ý

• Phiên bản Bitbucket trên hai máy phải giống nhau (8.3.0).
• Oracle trên máy mới nên cùng phiên bản (19c).
• Không khởi động đồng thời hai Bitbucket cùng sử dụng một Database.
• Sau khi chuyển thành công, cập nhật DNS hoặc Reverse Proxy để domain bit.eq.vn trỏ đến máy chủ mới.
• Nên sao lưu cả Bitbucket Home và Oracle Database trước khi thực hiện migrate để có thể khôi phục nếu cần.