Công việc hằng ngày

Làm việc bên trong workspace của bạn

Những gì bạn có bên trong một workspace đang chạy trong code-server: trình soạn thảo và các extension của nó, ứng dụng và cơ sở dữ liệu Archibus, log, kiểm thử email, git, và nơi các tệp của bạn nằm.

Thành viên khách hàngQuản trị viên khách hàngNgười vận hành nền tảng

Cập nhật lần cuối 29 tháng 6, 2026

Hướng dẫn này dành cho bất kỳ ai mở workspace và thực hiện công việc — thành viên, quản trị viên hoặc người vận hành. Bất kỳ ai có quyền truy cập vào workspace đều có thể mở nó trong code-server (VS Code trên trình duyệt) và sử dụng mọi thứ bên dưới. Việc tạo và khởi động workspace được trình bày trong Tạo workspace đầu tiên và Quản lý workspace; hướng dẫn này tiếp nối từ khi trình soạn thảo đã được mở.

Mở trình soạn thảo

Từ My Workspaces trong Console, tìm workspace đang chạy của bạn và bấm Browser. Trình soạn thảo sẽ mở trong một tab mới, đã trỏ sẵn đến thư mục ứng dụng (/home/codespace/applications). Nếu bạn thích dùng công cụ cục bộ của mình, menu overflow của hàng đó cũng có VS Code Desktop và JetBrains Gateway — chúng kết nối tới cùng workspace qua một tunnel.

Lần mở đầu tiên sau khi khởi động có thể mất vài giây trong lúc các extension hoàn tất cài đặt ở nền.

Nếu bạn muốn dùng ArchiBot trong VS Code cục bộ mà không có workspace được quản lý, trước tiên hãy dùng Sử dụng extension ArchiBot VS Code. Chế độ thư mục cục bộ cung cấp trợ giúp ở mức trình soạn thảo và tệp cho Archibus, còn chế độ workspace được mô tả ở đây bổ sung ứng dụng được quản lý, cơ sở dữ liệu, thông tin xác thực, log, và ngữ cảnh runtime.

Những gì đã được cài sẵn

Trình soạn thảo đã được thiết lập sẵn cho công việc Archibus, nên bạn hiếm khi phải tự cài đặt gì:

• ArchiBot — trợ lý trong workspace, ở panel thanh bên riêng của nó. Xem Sử dụng bot trong workspace.
• Một bộ công cụ Java đầy đủ — hỗ trợ ngôn ngữ, debugger, Maven, và Gradle — cho mã server của Archibus.
• SQLTools với driver SQL Server và Oracle, cùng một database client — kết nối tới cơ sở dữ liệu của workspace và chạy truy vấn từ trình soạn thảo.
• GitLens cho lịch sử và blame, Docker, YAML, EditorConfig, Prettier, markdownlint.
• Rainbow CSV và một Excel viewer cho các tệp dữ liệu.

Bạn có thể thêm extension riêng của mình; chúng nằm trong home của workspace và vẫn còn sau khi dừng/khởi động lại.

Ứng dụng Archibus

Hầu hết các workspace Archibus chạy Tomcat với Archibus WAR đã được triển khai sẵn dưới tomcat/webapps/archibus/. Tomcat lắng nghe trên cổng 8080.

• Mở ứng dụng đang chạy từ liên kết Tomcat trên trang workspace của Coder.
• Sau khi bạn thay đổi mã hoặc cấu hình, hãy khởi động lại Tomcat. Dùng hành động Restart Tomcat trên workspace, hoặc chạy ~/tomcat-service.sh restart trong terminal. ~/tomcat-service.sh status cho bạn biết nó có đang chạy hay không.
• Đầu ra của server được ghi vào ~/logs/catalina.out.

Cơ sở dữ liệu

Tùy theo cách workspace được dựng, nó sẽ chạy SQL Server (cổng 1433) hoặc Oracle (cổng 1521). Kết nối đã được cấu hình sẵn vào Archibus cho bạn — bạn không cần tự thiết lập thông tin xác thực. Các extension SQLTools và database-client đã được cài sẵn, và bot có thể chạy các truy vấn chỉ đọc cho bạn (nó sẽ không thay đổi dữ liệu). Thiết lập dự án và kết nối nằm trong WEB-INF/config/afm-projects.xml dưới thư mục ứng dụng.

Hoặc hãy nhờ bot tra cứu giúp bạn — nó chạy truy vấn bằng công cụ chỉ đọc của nó và hiển thị các dòng ngay trong terminal.

Nơi các thứ nằm

Một vài đường dẫn đáng biết:

• /home/codespace/applications — thư mục gốc của ứng dụng Archibus mà trình soạn thảo mở vào.
• ~/logs — startup.log (những gì đã chạy khi workspace khởi động), catalina.out (Tomcat), và mail-debug.log (email thử nghiệm).
• ~/flyway — cấu hình migration cơ sở dữ liệu, khi dùng Flyway.

Thư mục home của bạn là bộ nhớ lưu trữ bền vững. Nó tồn tại qua một lần stop và start, nhưng delete sẽ xóa workspace và ổ đĩa của nó. Với bất cứ thứ gì bạn muốn giữ qua các workspace — ghi chú, bằng chứng, bản nháp — hãy commit vào git hoặc lưu vào Shared Drive.

Email được chuyển tới hộp thư thử nghiệm

Vì vậy email của workspace sẽ không bao giờ đến người nhận thật, thư gửi đi được bắt bởi một máy chủ debug cục bộ trên 127.0.0.1:1025. Bạn có thể đọc nội dung app đã “gửi” trong ~/logs/mail-debug.log. Nếu bạn cần gửi thư thật, hãy đặt SMTP_DEBUG_DISABLE=1 trước khi khởi động Tomcat.

Git đã được xác thực sẵn

Quyền truy cập repository (Bitbucket hoặc GitLab) đã được thiết lập thông qua thông tin xác thực được quản lý, nên git pull, commit, và push hoạt động mà không cần bạn dán token vào. Hãy commit và push như bình thường. Đừng lưu token, key, hoặc tệp thông tin xác thực trong repo hoặc trong Shared Drive.

Hướng dẫn liên quan

• Sử dụng bot trong workspace — khởi động ArchiBot trong trình soạn thảo và giao việc cho nó.
• Sử dụng extension ArchiBot VS Code — so sánh chế độ workspace được quản lý, thư mục cục bộ, và không có thư mục.
• Quản lý workspace — khởi động, dừng, cập nhật, và lên lịch từ Console.
• Workspace ArchiBot và Shared Drive — lưu ghi chú và tài liệu tồn tại lâu hơn workspace.
• Khắc phục sự cố — các bước đầu tiên khi ứng dụng hoặc trình soạn thảo có vẻ không đúng.