Triển khai ứng dụng Windows và Codex CLI

Triển khai ứng dụng máy tính Windows, Codex CLI hoặc cả hai trên các thiết bị Windows được quản lý. Chọn ứng dụng để truy cập từ giao diện máy tính hoặc CLI để truy cập từ terminal.

Ứng dụng máy tính và CLI độc lập sử dụng các ngữ cảnh cài đặt khác nhau. Trước khi triển khai CLI, hãy chọn và xác minh tài khoản dùng để chạy trình cài đặt.

Triển khai ứng dụng Windows

Chọn phương thức dựa trên công cụ quản lý của bạn và khả năng truy cập các dịch vụ phân phối của Microsoft từ thiết bị.

Trước khi triển khai, hãy cấu hình các biện pháp kiểm soát áp dụng theo Cấu hình được quản lý. Để chuẩn bị thực thi lệnh Codex trong ứng dụng máy tính, hãy làm theo Thiết lập môi trường cô lập trên Windows. Kiểm tra khả năng tương thích của thiết bị và hoàn tất mọi bước thiết lập kiểu cũ cần thiết.

Các liên kết MSIX bên dưới tải xuống bản phát hành mới nhất cho từng kiến trúc, không phải phiên bản cũ. Xem xét gói đã tải xuống và lưu giữ bản đã được phê duyệt trong hệ thống triển khai của bạn. Làm theo Quản lý bản cập nhật ứng dụng để phối hợp trình cập nhật tích hợp của ứng dụng với Microsoft Store, Intune và các công cụ triển khai khác.

   #Requires -RunAsAdministrator
   $ErrorActionPreference = 'Stop'

   Add-AppxProvisionedPackage -Online `
     -PackagePath "$PSScriptRoot\ChatGPT.msix" `
     -LicensePath "$PSScriptRoot\ChatGPT-License.xml" `
     -Regions all

   #Requires -RunAsAdministrator
   $ErrorActionPreference = 'Stop'

   Get-AppxProvisionedPackage -Online |
     Where-Object DisplayName -eq 'OpenAI.Codex' |
     Remove-AppxProvisionedPackage -Online -AllUsers

   Get-AppxPackage -AllUsers -Name 'OpenAI.Codex' |
     Remove-AppxPackage -AllUsers

%SystemRoot%\Sysnative\WindowsPowerShell\v1.0\powershell.exe -NoProfile -File .\Install-ChatGPT.ps1

C:\Windows\Sysnative\WindowsPowerShell\v1.0\powershell.exe -NoProfile -File .\Uninstall-ChatGPT.ps1

$package = Get-AppxProvisionedPackage -Online -ErrorAction Stop |
  Where-Object DisplayName -eq 'OpenAI.Codex'

if ($package) {
  Write-Output $package.PackageName
  exit 0
}
exit 1

#Requires -RunAsAdministrator
$ErrorActionPreference = 'Stop'

Add-AppxProvisionedPackage -Online `
  -PackagePath "$PSScriptRoot\ChatGPT.msix" `
  -LicensePath "$PSScriptRoot\ChatGPT-License.xml" `
  -Regions all

winget install --id 9PLM9XGG6VKS -s msstore

   Add-AppxProvisionedPackage -Online `
     -PackagePath .\ChatGPT.msix `
     -LicensePath .\ChatGPT-License.xml `
     -Regions all

Triển khai Codex CLI trên Windows

Chuẩn bị gói CLI, áp dụng chính sách thiết bị và xác minh quyền truy cập từ terminal bằng tài khoản của nhân viên.

Trước khi bắt đầu

• Xác định các thiết bị Windows và người dùng mục tiêu cùng kiến trúc bộ xử lý của thiết bị, sau đó chọn phương thức cài đặt. Xác nhận rằng người dùng có quyền truy cập Codex và có thể hoàn tất quy trình đăng nhập của tổ chức.

• Với Intune, hãy chuẩn bị quyền quản lý ứng dụng, các thiết bị đã đăng ký đáp ứng điều kiện tiên quyết của Microsoft về đóng gói Win32 và một gói cài đặt không cần giám sát.

• Phân công trách nhiệm cập nhật và gỡ bỏ CLI. Nếu sử dụng npm, hãy tính đến bản cài đặt Node.js/npm được quản lý và vị trí gói toàn cục của bản cài đặt đó.

Chọn phương thức cài đặt

Chọn phương thức cài đặt và một bản phát hành CLI cụ thể. Xem các bản phát hành CLI trên GitHub, sau đó thay <approved-version> trong các ví dụ bằng số phiên bản đã được phê duyệt theo định dạng x.y.z. Sử dụng cùng một phiên bản trong gói và quy tắc phát hiện.

Trình cài đặt độc lập mặc định sử dụng latest khi không chỉ định bản phát hành. Đặt rõ -Release để cố định việc triển khai ở một bản phát hành; xem tham số bản phát hành của trình cài đặt. Để biết hướng dẫn cài đặt chung, xem Cài đặt CLI.

Trình cài đặt PowerShell độc lập. Trong một cửa sổ PowerShell mới, tải trình cài đặt xuống và truyền vào bản phát hành đã được phê duyệt:

$CodexRelease = '<approved-version>'
Invoke-WebRequest -UseBasicParsing -Uri 'https://chatgpt.com/codex/install.ps1' -OutFile '.\codex-install.ps1'
powershell -ExecutionPolicy Bypass -File .\codex-install.ps1 -Release $CodexRelease

npm. Nếu Node.js và npm đã được quản lý trên thiết bị, hãy chọn rõ phiên bản gói đã được phê duyệt:

$CodexRelease = '<approved-version>'
npm install -g "@openai/codex@$CodexRelease"

Để phân phối có quản lý, hãy lưu trình cài đặt hoặc tệp gói đã được rà soát cùng bản phát hành đã chọn trong gói do bộ phận CNTT quản lý. Xác định ngữ cảnh cài đặt, cách phát hiện, gỡ bỏ và cập nhật. Việc chọn phiên bản không thay đổi các thiết lập mặc định của trình cài đặt đối với hồ sơ người dùng và cũng không cung cấp một bộ script hoàn chỉnh cho việc triển khai không cần giám sát.

Thiết lập ngữ cảnh cài đặt

Theo mặc định, trình cài đặt độc lập đặt các tệp thời gian chạy trong hồ sơ của người dùng hiện tại, đặt thư mục lệnh tại %LOCALAPPDATA%\Programs\OpenAI\Codex\bin và sử dụng PATH của người dùng.

Chạy trình cài đặt chưa được sửa đổi dưới quyền SYSTEM sẽ nhắm đến hồ sơ và môi trường SYSTEM. Việc chọn System trong Intune không biến đây thành bản cài đặt cho tất cả người dùng.

Tách riêng việc cài đặt cho người dùng, phân phối chính sách thiết bị và thiết lập môi trường cô lập được quản trị viên phê duyệt. Khi một quy trình yêu cầu hồ sơ của nhân viên, hãy sử dụng danh tính của nhân viên đó thay vì SYSTEM.

Giữ các tệp thời gian chạy độc lập cùng nhau; chỉ sao chép codex.exe sẽ không tạo thành một gói độc lập hoàn chỉnh.

Đóng gói và gán CLI qua Intune

Chuẩn bị và xác minh một gói Win32 do bộ phận CNTT quản lý, bao gồm trình cài đặt không cần giám sát, trình gỡ cài đặt và logic phát hiện phù hợp với ngữ cảnh cài đặt đã chọn.

1. Chuẩn bị thư mục nguồn chứa các tệp cài đặt đã được phê duyệt và script thiết lập không cần giám sát. Chỉ định bản phát hành CLI đã được phê duyệt trong script đó thay vì để script tự xác định latest. Đặt công cụ đóng gói của Microsoft và thư mục đầu ra bên ngoài thư mục nguồn đó.

2. Tạo tệp .intunewin bằng Microsoft Win32 Content Prep Tool. Ví dụ này giả định script thiết lập đã được rà soát có tên là Install-Codex.ps1:

   IntuneWinAppUtil.exe -c C:\Packages\Codex\Source -s Install-Codex.ps1 -o C:\Packages\Codex\Output -q

Công cụ đóng gói nội dung của thư mục nguồn. Xem Tạo gói ứng dụng Win32.

3. Trong Intune, tạo một ứng dụng Windows (Win32) và tải gói lên.

4. Thiết lập các lệnh cài đặt và gỡ cài đặt, chế độ User hoặc System, các yêu cầu và quy tắc phát hiện cho phù hợp với gói.

5. Gán ứng dụng ở chế độ Bắt buộc hoặc Có sẵn cho thiết bị đã đăng ký.

Intune yêu cầu cài đặt không cần giám sát. Các tập lệnh phát hiện tùy chỉnh phải thoát với mã 0 và ghi vào stdout; đầu ra trên stderr sẽ khiến quá trình phát hiện thất bại. Xem Thêm và gán ứng dụng Win32.

Xác minh CLI từ tài khoản của nhân viên, ngay cả khi tác nhân quản lý báo cáo mã thoát thành công.

Đối với Configuration Manager (SCCM), hãy sử dụng phương án cài đặt CLI đã được rà soát trong quy trình triển khai ứng dụng, với trình cài đặt và quy tắc phát hiện dành riêng cho CLI. Các thiết lập MSIX của ứng dụng máy tính chỉ áp dụng cho ứng dụng máy tính.

Cấu hình các yêu cầu được quản lý

Triển khai các yêu cầu Windows do quản trị viên áp đặt đến:

%ProgramData%\OpenAI\Codex\requirements.toml

Phân phối tệp thông qua công cụ quản lý thiết bị đầu cuối của bạn. Cấp quyền đọc cho những người dùng được chỉ định và ngăn người dùng thông thường thay đổi chính sách thuộc quyền quản lý của quản trị viên.

Các yêu cầu giới hạn thiết lập; các giá trị cấu hình mặc định cung cấp giá trị ban đầu. Kiểm tra cả tệp cục bộ và chính sách đám mây áp dụng để xác định cấu hình có hiệu lực.

Chọn các yêu cầu về quyền, phê duyệt, truy cập mạng và hành vi của môi trường cô lập. Xem Cấu hình được quản lý để biết các trường được hỗ trợ và thứ tự ưu tiên.

Sau khi triển khai, khởi chạy Codex bằng tài khoản của nhân viên và sử dụng /status cùng /debug-config để xác nhận chính sách có hiệu lực. Việc cài đặt CLI hoặc phân phối các yêu cầu không cấp quyền truy cập không gian làm việc.

Cấu hình môi trường cô lập trên Windows

Kiểm tra khả năng tương thích của thiết bị trước khi chọn môi trường cô lập trên Windows. Hướng dẫn về môi trường cô lập trên Windows trình bày Microsoft Execution Containers (MXC) và các cơ chế triển khai cũ.

Ưu tiên MXC trên các thiết bị tương thích

Khi sử dụng CLI độc lập, bật tùy chọn ưu tiên MXC trong config.toml:

[features]
prefer_mxc = true

Bạn cũng có thể áp đặt giá trị của tính năng này thông qua requirements.toml. Tùy chọn ưu tiên này cho phép chuyển sang cơ chế dự phòng cũ khi MXC không khả dụng. Kiểm tra các yêu cầu về thiết bị trong hướng dẫn về môi trường cô lập trên Windows trước khi bật.

Trên CLI phiên bản 0.162.0 trở lên, chạy lệnh kiểm tra khả năng tương thích sau từ thư mục dự án:

codex -c windows.sandbox=mxc sandbox --include-managed-config --permission-profile :workspace -- cmd.exe /d /c echo MXC_OK
$LASTEXITCODE

Kết quả mong đợi là MXC_OK và mã thoát 0. Thao tác này kiểm tra lệnh chỉ định rõ MXC; hãy kiểm tra cả cấu hình phiên làm việc thông thường của nhân viên.

Trước khi triển khai trên diện rộng, đối chiếu các ràng buộc về mạng trong hướng dẫn về môi trường cô lập với chính sách mạng được quản lý của bạn.

Chuẩn bị cơ chế dự phòng cũ

Khi MXC không khả dụng hoặc bị vô hiệu hóa, hãy ưu tiên cơ chế dự phòng cũ elevated. Cơ chế này yêu cầu thiết lập được quản trị viên phê duyệt, nhưng các lệnh trong môi trường cô lập chạy mà không có quyền quản trị viên.

Làm theo quy trình thiết lập do bộ phận CNTT thực hiện cho tài khoản nhân viên và thư mục chính của Codex. Chạy ví dụ sau từ một tiến trình được nâng quyền phù hợp:

codex sandbox setup --elevated --user 'DOMAIN\alice' --codex-home 'C:\Users\alice\.codex'

Thay danh tính và đường dẫn mẫu bằng các giá trị của người dùng được chỉ định. Sử dụng bản cài đặt CLI được quản trị viên tin cậy để thiết lập với quyền nâng cao.

Để chỉ cho phép cơ chế triển khai cũ có quyền nâng cao, thêm nội dung sau vào %ProgramData%\OpenAI\Codex\requirements.toml, không phải config.toml. Xem Cấu hình cơ chế dự phòng cũ:

[windows]
allowed_sandbox_implementations = ["elevated"]

Thiết lập này giới hạn cơ chế dự phòng cũ mà không chặn MXC. Trước khi cho phép unelevated, hãy xem xét khả năng cách ly mạng yếu hơn và việc không hỗ trợ các đường dẫn bị cấm đọc của cơ chế này.

Xác minh việc triển khai CLI

Dùng tài khoản của nhân viên được chỉ định, mở một cửa sổ PowerShell mới không có quyền quản trị viên:

Get-Command codex
codex --version
codex

Xác nhận rằng tệp thực thi được tìm thấy thuộc bản cài đặt mong muốn, sau đó hoàn tất quy trình đăng nhập đã được phê duyệt. Chạy một tác vụ nhỏ trong dự án kiểm thử được chỉ định và kiểm tra cấu hình đang có hiệu lực.

Quản lý bản cập nhật

Ứng dụng máy tính

Theo mặc định, ứng dụng kiểm tra bản cập nhật, kể cả sau khi cài đặt ngoại tuyến. Để bật cập nhật tự động, cho phép thiết bị truy cập persistent.oaistatic.com. Nếu tắt cập nhật tự động, hãy triển khai các gói mới hơn thông qua công cụ quản lý của bạn.

Làm theo hướng dẫn Quản lý bản cập nhật ứng dụng để phối hợp tất cả các nguồn cập nhật. Việc vô hiệu hóa trình cập nhật tích hợp không ngăn Microsoft Store, Intune hoặc các công cụ quản lý khác cập nhật ứng dụng, cũng không cung cấp khả năng ghim phiên bản do OpenAI quản lý hay một kênh phát hành riêng. Xác nhận phiên bản đã cài đặt thông qua hệ thống triển khai của bạn.

Codex CLI

Với mỗi lần cập nhật CLI, chọn một bản phát hành mới đã được phê duyệt, cập nhật giá trị -Release được chỉ định rõ hoặc phiên bản gói npm trong gói triển khai, đồng thời cập nhật quy tắc phát hiện của gói đó. Triển khai theo quy trình đóng gói của bạn, sau đó xác minh phiên bản đã cài đặt, ngữ cảnh tài khoản và hành vi phát hiện. Không chuyển gói được quản lý trở lại sử dụng lệnh cài đặt không chỉ định rõ bản phát hành. Xem Các bản phát hành CLI, Cài đặt và cập nhật CLI và Chọn phiên bản npm.

Khắc phục sự cố

Cài đặt và cấu hình Codex CLI

Tài nguyên liên quan

• Cài đặt CLI

• Cấu hình được quản lý

• Thiết lập môi trường cô lập trên Windows

• Ứng dụng ChatGPT dành cho máy tính Windows

• Xem hướng dẫn đóng gói Win32 của Microsoft

• Xem cài đặt triển khai Win32 của Microsoft