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 khi kết nối cho quý vị

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

Trước khi 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 tại Bitbucket

Bitbucket cung cấp hai loại thông tin xác thực, và cả hai đều hoạt động được:

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

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

Mở 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 token trên tài khoản Atlassian thay vì token truy cập, hãy điền cả mục Account username, sau đó nhấn Connect account.

Chúng tôi kiểm tra những gì quý vị dán trước khi lưu bất cứ điều gì. 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 khóa đó bị lỗi gì. Khóa hoạt động được sẽ được lưu trữ mã hóa trong kho bí mật của chúng tôi — không bao giờ lưu trong cơ sở dữ liệu của chúng tôi — và không bao giờ được hiển thị lại, kể cả với quý vị.

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

Điều gì 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: hãy chọn tài khoản đó trên kết nối kho lưu trữ của trang web, chọn kho lưu trữ cùng nhánh, và thao tác đẩy mã nguồn sẽ tiến hành triển khai.
• Mỗi nhánh khác đều có thể có 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 dịch vụ lưu trữ tĩnh được xây dựng từ Git như Render và Azure Static Web Apps sẽ sử dụng kết nối này làm nguồn mã nguồn của trang web.

Nếu không kết nối được

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

Đã hoạt động rồi sau đó dừng lại. Cả hai loại token đều có thể hết hạn. Hãy tạo một token mới và kết nối lại.

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

Kết nối thành công, nhưng sau đó xảy ra lỗi. Khóa đã xác thực nhưng thiếu quyền mà tác vụ yêu cầu. Hãy tạo một 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 khóa đã lưu trữ ngay lập tức. Bất kỳ tác vụ nào đang sử dụng khóa sẽ dừng lại ở hành động tiếp theo, và các màn hình phụ thuộc vào nó sẽ thông báo điều đó thay vì âm thầm gặp lỗi.

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