Bỏ qua, đến phần nội dung

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 đặtMột máy (deploy.env)Helm
Slug tổ chứcTARA_SINGLE_ORG=acmeconfig.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/orgs bị tắt (API trả 403 org_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, member hoặc viewer). 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ò member khi đă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:

bash
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ức

Nhữ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:

RoleAi dùngQuyền
Chủ cơ sở dữ liệu (ví dụ tara)tara-admin migrate, tạo role ứng dụng, bật pgvectorSở hữu bảng và chạy migration
tara_apptara-api, tara-worker và mọi lệnh tara-admin khácKhô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ếnAi dùngÝ nghĩa
TARA_DATABASE_URLAPI, workerKết nối bằng tara_app, ví dụ postgres://tara_app:<mật-khẩu>@db.example.com:5432/tara
TARA_APP_DB_PASSWORDMigrationMậ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_URLMigrationKết nối bằng chủ cơ sở dữ liệu. Mặc định là TARA_DATABASE_URL
TARA_ENVAPI, workerproduction 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:

sql
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ướcSau
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úngTổ chức default, lớp riêng của tổ chức
Admin và reviewer của rndTà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ácAdmin
Publisher và memberMember
PMViewer
Project Ryoma của một trung tâmProject của default
Token API và token telemetryGắ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.

  1. Sao lưu cơ sở dữ liệu PostgreSQL của Tara.
  2. Thêm TARA_APP_DB_PASSWORD và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ới TARA_MIGRATE_DATABASE_URL).
  3. Đặt TARA_SINGLE_ORG=default nế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ó.
  4. Nâng cấp. Migration chạy trước, tạo tara_app, chuyển dữ liệu, và seed-config bảo đảm các tổ chức có sẵn. Sau đó API kết nối lại bằng tara_app.
  5. 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.

Đọc thêm ​