Cài đặt Orbit Station

Trang này hướng dẫn bạn cài Station lên máy Windows, khởi động lần đầu và chạy test đầu tiên. Bạn không cần setup gì thêm trên máy: không cần SSH key, không cần config Git, không cần password của repo.

Trang này dành cho ai

QA Engineer sẽ chạy test trên máy của mình, và System Admin là người enroll máy. Bạn không cần biết Orbit hoạt động bên trong ra sao.

Trước khi bắt đầu

• Một máy Windows 10 (version 1803 trở lên) hoặc Windows 11, có kết nối internet.

• Đã cài Git for Windows với các option mặc định (https://git-scm.com/download/win). Nếu máy chưa có Git, installer sẽ báo và mở trang download.

• Một account Orbit có role QA Engineer trở lên trong project của bạn. Role Viewer chỉ xem được, không chạy được.

• Một enrollment code và một installer link. Bạn nhận cả hai theo một trong hai cách:

  • Self-service (phần lớn tester): bạn request một Station trong trang Profile; khi System Admin approve, bạn tự tạo code. Xem Tự lấy code.
  • Từ admin: System Admin tạo code cho bạn. Xem Lấy code từ admin.

  Mỗi code chỉ dùng được một lần và hết hạn sau 24 giờ (code self-service hết hạn muộn nhất khi thời hạn approve của bạn kết thúc). Vì vậy, hãy lấy code khi bạn đang ngồi ở máy và sẵn sàng cài đặt.

Tự lấy code

1. Trong Console, mở menu avatar, chọn Profile, rồi chọn tab Station.
2. Trong phần Request a Station, nhập PC name và, nếu muốn, một lý do ngắn. Chọn Send request.
   • Tên máy theo quy tắc đặt tên máy của Windows: từ 2 đến 60 ký tự gồm chữ cái, chữ số, dấu chấm, dấu gạch ngang hoặc dấu gạch dưới, bắt đầu bằng chữ cái hoặc chữ số, không có khoảng trắng (ví dụ LDN-QA-08).
   • Dùng đúng tên của máy: trên Windows, tên này nằm ở Settings, System, About, Device name.
   • Tên máy phải chưa được dùng: không có Station nào khác hay request nào đang mở dùng tên đó. Nếu tên đã bị dùng, Console sẽ báo; hãy chọn tên máy khác.
   • Bạn gửi được tối đa 5 request mỗi ngày. Quá số đó, thử lại vào hôm sau hoặc nhờ System Admin.
3. Mọi System Admin đều nhận notification. Chờ quyết định: bạn cũng sẽ nhận notification. Đó là setting Station requests to review (System admins), and the decision on mine trên trang Notifications, tab Settings (từ Profile, Preferences: Choose which notifications you get). Trong lúc chờ, tab hiển thị Request pending cùng nút Cancel request.
4. Nếu request bị rejected, tab hiển thị ghi chú của admin. Bạn có thể gửi request mới.
5. Nếu request được approved, tab hiển thị Install cùng tên máy của bạn. Bạn có 7 ngày kể từ lúc được approve để lấy code. System Admin cũng có thể rút lại approval trước khi bạn cài đặt; khi đó bạn gửi request mới.
6. Khi bạn đang ở máy, chọn Get installation code. Console hiển thị code một lần duy nhất, cùng installer link và ba bước (Git, installer, dán code). Dùng Copy code, rồi làm theo phần Cài đặt.

Lưu ý:

• Code không bao giờ được gửi qua email và admin không bao giờ thấy code. Khi bạn rời trang hoặc chọn Done, code bị ẩn vĩnh viễn.
• Mất code, hoặc code đã hết hạn? Chọn Get a new code trong thời hạn 7 ngày. Code mới thay thế code cũ chưa dùng.
• Code hết hạn sau 24 giờ, hoặc sớm hơn nếu thời hạn approve 7 ngày kết thúc trước: code không bao giờ sống lâu hơn approval.
• Sau 7 ngày mà chưa cài đặt, hãy request Station lại.
• Một request đã dùng hết khi Station của nó đã enroll: tab sẽ hiển thị “PC name is enrolled” và không cấp thêm code. Muốn dùng cho máy khác, hãy gửi request mới, kể cả khi Station đó sau này bị gỡ.
• Station được enroll dưới tên bạn và có trong danh sách My Stations trên cùng tab, kèm version, lần cuối được thấy và trạng thái online hoặc đã revoke. Bạn không tự revoke hay gỡ Station được: hãy nhờ System Admin.

Lấy code từ admin

System Admin tạo code trong Console, tại Admin, Stations, Add station, rồi đưa bạn code và installer link. Cách này dành cho các máy do admin setup, ví dụ máy dùng chung trong phòng lab; khi đó Station không có owner. System Admin cũng approve các request self-service trên cùng trang, tab Requests. Tại đó, Withdraw approval… hủy một approval chưa enroll Station nào. Trên tab Stations, trong phần Waiting to enroll, Void… vô hiệu hóa ngay một code chưa dùng (của admin hoặc của người request).

Cài đặt

1. Download installer từ link (install-orbit-station.cmd) và mở nó. Nếu Windows SmartScreen hỏi, chọn More info, rồi Run anyway.
2. Installer download Station về (khoảng 40 MB), kiểm tra file còn nguyên vẹn và giải nén cho user Windows của bạn. Bạn không cần quyền admin trên máy.
3. Khi được hỏi enrollment code, dán code vào (bấm chuột phải để dán; code được ẩn đi) và nhấn Enter.
4. Khi được hỏi Start Orbit Station now, nhấn Y. Một cửa sổ mở ra, sau đó browser hiển thị Station.
5. Đăng nhập bằng email và password Orbit của bạn. Nếu tổ chức của bạn dùng authenticator (MFA), nhập code của authenticator khi được hỏi.

Station giờ đã có trong menu Start với tên Orbit Station. Để cửa sổ của nó mở trong lúc làm việc.

Chạy test đầu tiên

1. Chọn Run trong menu bên trái.
2. Chọn project (trên thanh ở đầu trang), environment và workload, rồi chọn Start run.
3. Run đi qua các bước Checkout, Install, Lock and secrets, Running và Collecting results. Run đầu tiên trên một máy sẽ chậm hơn: Station download các thư viện cần cho test và các browser. Những run sau dùng lại chúng.

Station làm gì giúp bạn

• Station tự update. Khi có version mới, mục Update trên status bar hiển thị “version ready” và có nút Restart to update. Nút này cũng có trong Settings, Station (dòng Updates) và trên trang About Orbit Station.
• Station đọc các test repo private bằng một key read-only, thời hạn ngắn, do Console cấp. Bạn không bao giờ phải nhập password của repo.
• Station có thể tự khởi động khi bạn đăng nhập Windows. Bật hoặc tắt trong Settings, tab Station, General: Start Orbit Station when I sign in to Windows.

Khi gặp sự cố

Bạn thấy	Cách xử lý
“Git for Windows is needed” trong installer	Cài Git với các option mặc định, rồi chạy lại installer.
“The download is damaged or was changed”	Chạy lại installer. Nếu vẫn lặp lại, báo System Admin.
Enrollment code bị từ chối	Mỗi code chỉ dùng một lần và hết hạn sau 24 giờ (hoặc khi thời hạn approve kết thúc), code mới làm code cũ mất hiệu lực, và admin có thể đã void code. Lấy code mới trong Profile, Station (khi approval còn hiệu lực) hoặc nhờ admin.
Không thấy Get installation code	Request của bạn vẫn đang chờ, đã bị reject hoặc bị rút lại, đã enroll một Station, hoặc thời hạn 7 ngày sau khi approve đã hết. Tab Station cho biết lý do; gửi request lại nếu cần.
“Another Station or request already uses this name”	Chọn tên máy khác, thường là Device name của chính máy đó.
“You made several requests today”	Giới hạn là 5 request mỗi ngày. Thử lại vào ngày mai hoặc nhờ System Admin.
“You need a role in a project to request a Station”	Nhờ Project Admin thêm bạn vào một project, rồi gửi request lại.
Installing the workload failed trong một run	Mở Diagnostics từ thẻ báo lỗi. Trang này kiểm tra mọi repo mà workload cần và cho biết repo nào không đọc được. Nếu vẫn lỗi, gửi cho admin log của run (khung Log) và trang Diagnostics.
“The Station could not read a repository the workload needs”	Một repo mà workload dùng không nằm trong tổ chức Orbit, hoặc workload cần được register lại. Việc này do Project Admin hoặc System Admin xử lý, không phải bạn.
Một test bị timeout ở run đầu tiên trong ngày	Hệ thống đang được test có thể đang khởi động. Chạy lại sau vài phút.

Gỡ Station (và cài lại từ đầu)

1. Đóng cửa sổ Station và tab browser.

2. Nhờ System Admin Revoke… rồi Remove… máy của bạn trong Admin, Stations trên Console (run history của bạn vẫn được giữ).

3. Trong PowerShell, chạy:

   Remove-Item -Recurse -Force "$env:LOCALAPPDATA\Orbit\Station"
   Remove-Item "$env:APPDATA\Microsoft\Windows\Start Menu\Programs\Orbit Station.lnk" -ErrorAction SilentlyContinue
   Remove-Item "$env:APPDATA\Microsoft\Windows\Start Menu\Programs\Startup\Orbit Station (autostart).lnk" -ErrorAction SilentlyContinue

   Lệnh này xóa Station, thông tin đăng nhập của nó và history lưu trên máy này.

4. Cài lại với một enrollment code mới.

Các giá trị cần ghi lại

Giá trị	Nơi tìm	Loại
Installer link	Profile, Station, cùng với code của bạn; hoặc từ System Admin (Console hiển thị nó cạnh Add station)	Thông thường; có thể chia sẻ
Enrollment code	Profile, Station, Get installation code (self-service); hoặc Admin, Stations, Add station	Chỉ hiển thị một lần, dùng một lần, có hiệu lực 24 giờ; dán thẳng vào installer, không lưu lại và không chia sẻ
Tên máy trong request của bạn	Tên bạn đã nhập trong Request a Station	Thông thường; Station được enroll dưới tên này
Ngày hết thời hạn approve	Profile, Station, trong phần Install	Thông thường; sau ngày này phải request lại; code không bao giờ có hiệu lực lâu hơn ngày này
Tên Station	Hiển thị trên Station sau khi enroll	Thông thường
Version Station	About trên Station	Thông thường