Tự cài một tổ chức
Dịch vụ PhillipCLI dùng chung cho phép ai cũng tự đăng ký và tạo tổ chức. Bản tự cài thường chỉ phục vụ một công ty. Cho trường hợp này, Tara có chế độ một tổ chức: một tổ chức cố định, không có màn hình Create organization, và nguồn đăng nhập lấy từ cấu hình của bạn. Trang này nói cách bật chế độ đó, role cơ sở dữ liệu giữ cho các tổ chức không lẫn dữ liệu, và cách chuyển một bản cài còn dùng trung tâm. Nội dung áp dụng cho cả bản một máy (Docker Compose) và Helm.
Bật chế độ một tổ chức
Đặt TARA_SINGLE_ORG là slug tổ chức của bạn, ví dụ acme (chữ thường, số và gạch ngang).
| Cài đặt | Một máy (deploy.env) | Helm |
|---|---|---|
| Slug tổ chức | TARA_SINGLE_ORG=acme | config.singleOrg: acme |
| Tổ chức GitHub có thành viên tự vào (tùy chọn) | TARA_GITHUB_ORG=<github-org> | config.githubOrg: <github-org> |
Khi đã đặt TARA_SINGLE_ORG:
POST /v1/orgsbị tắt (API trả 403org_creation_disabled), và Portal ẩn nút Create organization.- Người đăng nhập bằng GitLab hoặc OIDC vào tổ chức này với vai trò mà nhóm của họ ánh xạ tới (
admin,memberhoặcviewer). Xem Đăng nhập SSO và Chuẩn bị GitHub và GitLab. - Nếu bạn đặt thêm
TARA_GITHUB_ORG, thành viên của tổ chức GitHub đó vào với vai tròmemberkhi đăng nhập. Họ rời tổ chức GitHub thì lần đăng nhập sau Tara gỡ tư cách thành viên. Nếu tổ chức hết seat thì việc vào bị từ chối. Người đó vẫn đăng nhập được, và owner hoặc admin có thể giải phóng seat hoặc mời họ.
Khi không đặt TARA_SINGLE_ORG (chế độ dịch vụ dùng chung), đăng nhập GitHub không kiểm tra tổ chức, không ai vào tổ chức chỉ nhờ đăng nhập, và TARA_GITHUB_ORG bị bỏ qua kèm một cảnh báo trong log. Ở chế độ này, ánh xạ nhóm GitLab và OIDC vẫn đi vào tổ chức default, để bản cài đã dùng chúng từ trước vẫn chạy.
Tổ chức phải có sẵn
Tara không khởi động nếu việc tự vào khi đăng nhập cần một tổ chức chưa có trong cơ sở dữ liệu. Tổ chức do tara-admin seed-config tạo, lệnh này đọc danh sách orgs trong cấu hình seed và chạy trong make migrate, trong bước tara-migrate của bản một máy, và trong Job migration của Helm. Seed có sẵn hai tổ chức: aiforge (kho chính thức) và default. Vậy bạn có hai cách: dùng TARA_SINGLE_ORG=default, hoặc thêm tổ chức của bạn vào danh sách orgs rồi chạy lại migration. Lệnh này chạy nhiều lần vẫn an toàn.
Các biến môi trường chỉ dùng để khởi tạo
TARA_GITHUB_ORG, TARA_GITLAB_PROVIDERS và TARA_OIDC_PROVIDERS không còn quyết định ai được đăng nhập vào cả dịch vụ. Chúng chỉ dựng nguồn đăng nhập ban đầu của tổ chức duy nhất này. Trên dịch vụ dùng chung, việc cấu hình đăng nhập riêng cho từng tổ chức sẽ chuyển vào Portal, đang sắp có.
Owner đầu tiên
Không ai vào tổ chức chỉ nhờ đăng nhập, nên hãy cho người đầu tiên làm owner sau khi họ đăng nhập một lần:
tara-admin grant <login> acme owner
tara-admin staff create <login> --role moderator --email <email> # tùy chọn: tài khoản staff của admin console, duyệt kho chính thứcNhững người còn lại vào qua ánh xạ nhóm, TARA_GITHUB_ORG hoặc lời mời (ph org invite <email> --role member, hoặc mục Members trên Portal). Gói Free có 7 seat cho owner, admin và member. Viewer (BA, PO, PM, chỉ dùng trình duyệt) không tính seat.
Role cơ sở dữ liệu tara_app
Tara cách ly các tổ chức bằng Row-Level Security (RLS) của PostgreSQL, mà RLS không có tác dụng với superuser hay role có BYPASSRLS. Vì vậy Tara dùng hai role cơ sở dữ liệu:
| Role | Ai dùng | Quyền |
|---|---|---|
Chủ cơ sở dữ liệu (ví dụ tara) | tara-admin migrate, tạo role ứng dụng, bật pgvector | Sở hữu bảng và chạy migration |
tara_app | tara-api, tara-worker và mọi lệnh tara-admin khác | Không superuser, không BYPASSRLS. Chỉ đọc và ghi dữ liệu, không có DDL. Quyền mặc định bao cả bảng do migration sau này tạo |
Các biến:
| Biến | Ai dùng | Ý nghĩa |
|---|---|---|
TARA_DATABASE_URL | API, worker | Kết nối bằng tara_app, ví dụ postgres://tara_app:<mật-khẩu>@db.example.com:5432/tara |
TARA_APP_DB_PASSWORD | Migration | Mật khẩu của tara_app. Khi đã đặt, tara-admin migrate up tạo hoặc cập nhật role ở mỗi lần chạy và cấp quyền trên mọi bảng |
TARA_MIGRATE_DATABASE_URL | Migration | Kết nối bằng chủ cơ sở dữ liệu. Mặc định là TARA_DATABASE_URL |
TARA_ENV | API, worker | production khiến cả hai không khởi động nếu role cơ sở dữ liệu là superuser hoặc có BYPASSRLS. Giá trị khác chỉ ghi cảnh báo |
Chỉ bước migration được thấy thông tin của chủ cơ sở dữ liệu. API và worker không bao giờ cần đến.
Bản một máy (Docker Compose)
./init-env.sh sinh TARA_APP_DB_PASSWORD trong deploy.env. docker-compose.yml đặt TARA_ENV: production, cho API và worker kết nối bằng tara_app, và chỉ đưa kết nối của chủ cơ sở dữ liệu cho dịch vụ tara-migrate chạy một lần và cho tara-admin. Bạn chạy lệnh quản trị bằng cùng lối tắt như trước, ví dụ dc run --rm --no-deps tara-admin grant <login> acme owner.
Helm
Đặt TARA_DATABASE_URL (dùng tara_app) trong Secret chính (secrets.existingSecret). Đặt TARA_MIGRATE_DATABASE_URL và TARA_APP_DB_PASSWORD trong Secret thứ hai mà chỉ Job migration đọc (migration.existingSecret). Mật khẩu trong TARA_APP_DB_PASSWORD phải là mật khẩu nằm trong TARA_DATABASE_URL. config.env mặc định là production.
Khi API không khởi động
Nếu lỗi nhắc tới tara_app, nghĩa là API hoặc worker đã kết nối bằng superuser hoặc role BYPASSRLS trong khi TARA_ENV=production. Hãy đặt TARA_APP_DB_PASSWORD, chạy migration để role có sẵn, rồi trỏ TARA_DATABASE_URL vào tara_app. Muốn tự kiểm tra, chạy lệnh sau bằng chủ cơ sở dữ liệu và kết quả phải là f:
select rolsuper or rolbypassrls from pg_roles where rolname = 'tara_app';Chuyển từ mô hình trung tâm cũ
Trung tâm đã được thay bằng tổ chức. Migration chuyển dữ liệu của bạn trong một bước khi nâng cấp, không cần dump:
| Trước | Sau |
|---|---|
Tài nguyên của trung tâm rnd (kho chính thức) | Tài nguyên của tổ chức nền tảng aiforge, lớp chính thức |
| Mọi trung tâm còn lại và tài nguyên của chúng | Tổ chức default, lớp riêng của tổ chức |
Admin và reviewer của rnd | Tài khoản staff của admin console (moderator), đồng thời là Owner của default |
| Admin và reviewer của trung tâm khác | Admin |
| Publisher và member | Member |
| PM | Viewer |
| Project Ryoma của một trung tâm | Project của default |
| Token API và token telemetry | Gắn vào default |
Hai bảng cũ centers và memberships bị xóa sau khi dữ liệu đã chuyển. Hãy sao lưu trước khi nâng cấp.
- Sao lưu cơ sở dữ liệu PostgreSQL của Tara.
- Thêm
TARA_APP_DB_PASSWORDvào cấu hình (bản một máy: chạy./init-env.sh, script chỉ thêm giá trị còn thiếu; Helm: thêm vào Secret migration cùng vớiTARA_MIGRATE_DATABASE_URL). - Đặt
TARA_SINGLE_ORG=defaultnếu muốn giữ tổ chức hiện tại, hoặc thêm một tổ chức mới vào cấu hình seed rồi dùng slug của nó. - Nâng cấp. Migration chạy trước, tạo
tara_app, chuyển dữ liệu, vàseed-configbảo đảm các tổ chức có sẵn. Sau đó API kết nối lại bằngtara_app. - Kiểm tra bằng
tara-admin members, rồi đăng nhập Portal và xem mọi người đã có vai trò đúng như bảng trên chưa.
Manifest còn dùng metadata.forge.center vẫn đọc được và hiện cảnh báo ngừng dùng. Hãy đổi sang metadata.forge.org. Mô hình vai trò xem ở Vai trò và quyền.