Kết nối tài khoản Bitbucket của bạn để các trang web của bạn được triển khai từ một kho lưu trữ

Lợi ích của việc kết nối

Kết nối Bitbucket cho phép một trang web được triển khai từ một trong các kho lưu trữ Bitbucket Cloud của quý vị: đẩy mã lên nhánh và trang web sẽ được cập nhật.

Trước khi quý vị bắt đầu

Một tài khoản Bitbucket Cloud có quyền truy cập vào các kho lưu trữ mà quý vị muốn triển khai.

1. Tạo khóa trên Bitbucket

Bitbucket cung cấp hai loại thông tin xác thực và loại nào cũng dùng được:

• Mã thông báo truy cập cho kho lưu trữ, dự án hoặc không gian làm việc, được tạo từ cài đặt riêng của kho lưu trữ, dự án hoặc không gian làm việc đó trong mục Access tokens. Khóa này gắn liền với kho lưu trữ, dự án hoặc không gian làm việc đó chứ không gắn với cá nhân nào. Hãy cấp quyền đọc cho các kho lưu trữ.
• Mã thông báo API trên tài khoản Atlassian của quý vị. Chọn hồ sơ của quý vị, sau đó vào Account settings → Security → Create and manage API tokens → Create API token with scopes. Đặt tên cho mã thông báo, đặt thời hạn hết hạn, chọn Bitbucket làm ứng dụng và chọn quyền đọc cho các kho lưu trữ. Bitbucket chỉ hiển thị mã thông báo một lần; hãy sao chép mã đó lúc này.

2. Kết nối tại đây

Mở phần Integrations trong bảng điều khiển của quý vị và chọn Connect an account. Chọn Code hosting làm nhóm và Bitbucket làm tài khoản, điền vào mục API token — và, nếu quý vị đã tạo mã thông báo trên tài khoản Atlassian thay vì mã thông báo truy cập, hãy điền cả mục Account username, sau đó nhấn Connect account.

Chúng tôi kiểm tra nội dung quý vị dán trước khi lưu bất kỳ thông tin nào. Khóa không hoạt động sẽ không bao giờ được lưu trữ và phản hồi sẽ cho biết lỗi của khóa đó. Khóa hoạt động được lưu giữ ở trạng thái mã hóa trong kho bảo mật của chúng tôi — không bao giờ trong cơ sở dữ liệu của chúng tôi — và không bao giờ được hiển thị lại, ngay cả với quý vị.

Tên người dùng quyết định cách chúng tôi gửi mã thông báo, vì vậy chỉ nhập tên người dùng đối với mã thông báo tài khoản. Mã thông báo truy cập được nhập kèm tên người dùng, hoặc mã thông báo tài khoản không có tên người dùng, sẽ bị từ chối.

Điều gì sẽ xảy ra tiếp theo

• Một trang web có thể triển khai trực tiếp từ một kho lưu trữ trên tài khoản này: chọn kho lưu trữ đó trong mục kết nối kho lưu trữ của trang web, chọn kho lưu trữ và nhánh, và thao tác đẩy mã sẽ kích hoạt triển khai.
• Mọi nhánh khác đều có thể nhận bản xem trước riêng, nhờ đó quý vị có thể kiểm tra thay đổi trước khi đưa lên trang web chính thức.
• Các máy chủ tĩnh được xây dựng bằng Git như Render và Azure Static Web Apps sử dụng kết nối này làm nguồn mã cho trang web.

Nếu kết nối không thành công

Thiếu kho lưu trữ. Mã thông báo truy cập chỉ có hiệu lực trong kho lưu trữ, dự án hoặc không gian làm việc nơi nó được tạo. Hãy tạo mã thông báo ở cấp độ bao quát mọi kho lưu trữ quý vị cần.

Kết nối thành công rồi sau đó dừng lại. Cả hai loại mã thông báo đều có thể hết hạn. Hãy tạo mã thông báo mới và kết nối lại.

Thông báo khóa bị từ chối. Hầu như luôn do một trong ba nguyên nhân sau: khoảng trắng hoặc ngắt dòng bị sao chép kèm theo, khóa đã hết hạn, hoặc khóa đã bị thu hồi hoặc tạo lại sau khi quý vị sao chép. Hãy tạo khóa mới và dán lại.

Kết nối thành công, nhưng thao tác sau đó gặp lỗi. Khóa xác thực thành công nhưng thiếu quyền cần thiết cho hành động đó. Hãy tạo khóa mới với các quyền được liệt kê ở trên, sau đó ngắt kết nối cũ và kết nối khóa mới.

Ngắt kết nối

Mở Integrations, tìm tài khoản và nhấn Disconnect. Thao tác này sẽ xóa ngay lập tức khóa đã lưu trữ. Bất kỳ tính năng nào đang sử dụng khóa đó sẽ dừng lại ở thao tác tiếp theo, và các màn hình phụ thuộc vào nó sẽ hiển thị thông báo thay vì lỗi ngầm.

Ngắt kết nối không làm hoàn tác những gì đã thực hiện — các bản ghi, bản triển khai hoặc cài đặt mà chúng tôi đã thay đổi trên tài khoản của quý vị sẽ được giữ nguyên. Nếu quý vị cho rằng bản thân khóa có thể đã bị rò rỉ, vui lòng thu hồi khóa đó tại bên cung cấp; việc ngắt kết nối chỉ xóa bản sao của chúng tôi chứ không xóa bản của họ.