Kiểm thử và gỡ lỗi tiện ích bổ sung HTTP của Google Workspace

Là nhà phát triển tiện ích bổ sung cho Google Workspace, bạn có thể cần gỡ lỗi mã để kiểm thử các thay đổi hoặc khắc phục các vấn đề phức tạp. Bạn có thể gỡ lỗi tiện ích bổ sung Google Workspace theo nhiều cách khác nhau, tuỳ thuộc vào cấu trúc ứng dụng, chức năng của ứng dụng, cách triển khai ứng dụng và lựa chọn ưu tiên của bạn.

Trang này giải thích cách gỡ lỗi một tiện ích bổ sung Google Workspace HTTP bằng ngrok. Đây là một nền tảng truy cập hợp nhất mà bạn có thể dùng để kiểm thử môi trường phát triển cục bộ. Trong hướng dẫn này, bạn sẽ kiểm thử các thay đổi về mã trong môi trường cục bộ và khắc phục sự cố trong môi trường từ xa.

Gỡ lỗi từ môi trường phát triển cục bộ

Trong phần này, bạn sẽ tương tác với tiện ích bổ sung Google Workspace thực thi trong môi trường cục bộ.

Hình 1. Gỡ lỗi trong môi trường phát triển cục bộ.

Điều kiện tiên quyết

Node.js

• Phiên bản mới nhất của node và npm đã cài đặt trong môi trường cục bộ.

• Đã cài đặt phiên bản mới nhất của nodemon trong môi trường cục bộ. Số điện thoại này được dùng cho mục đích tự động nạp lại:

  npm install -g nodemon

• Một dự án trên Google Cloud. Bạn có thể làm theo các phần Điều kiện tiên quyết và Thiết lập môi trường trong Hướng dẫn bắt đầu nhanh.

• Mã của tiện ích bổ sung Google Workspace để gỡ lỗi trong môi trường cục bộ. Chúng tôi sử dụng các tính năng liên kết xem trước từ ví dụ về mã 3p-resources trong kho lưu trữ GitHub googleworkspace/add-ons-samples trong hướng dẫn này cho mục đích minh hoạ.

• Một IDE được thiết lập trong môi trường cục bộ có thể gỡ lỗi. Chúng tôi sử dụng Visual Studio Code IDE và các tính năng gỡ lỗi mặc định của IDE trong hướng dẫn này cho mục đích minh hoạ.

• Tài khoản ngrok.

• Phiên bản mới nhất của gcloud được cài đặt và khởi chạy trong môi trường cục bộ của bạn.

Python

• Phiên bản mới nhất của python3 được cài đặt trong môi trường cục bộ của bạn.
• Phiên bản mới nhất của pip và virtualenv được cài đặt trong môi trường cục bộ. Chúng được dùng để quản lý các gói Python và môi trường ảo tương ứng.
• Một dự án trên Google Cloud. Bạn có thể làm theo các phần Điều kiện tiên quyết và Thiết lập môi trường của Hướng dẫn bắt đầu nhanh.
• Mã của tiện ích bổ sung Google Workspace để gỡ lỗi trong môi trường cục bộ. Chúng tôi sử dụng các tính năng liên kết xem trước từ ví dụ về mã 3p-resources trong kho lưu trữ GitHub googleworkspace/add-ons-samples trong hướng dẫn này cho mục đích minh hoạ.
• Một IDE được thiết lập trong môi trường cục bộ có thể gỡ lỗi. Chúng tôi sử dụng Visual Studio CodeIDE và các tính năng gỡ lỗi mặc định của IDE trong hướng dẫn này cho mục đích minh hoạ.
• Tài khoản ngrok.
• Phiên bản mới nhất của gcloud được cài đặt và khởi chạy trong môi trường cục bộ của bạn.

Java

• Phiên bản ổn định mới nhất của Java SE 11's JDK đã cài đặt trong môi trường cục bộ.
• Phiên bản mới nhất của Apache Maven được cài đặt trong môi trường cục bộ của bạn. Công cụ này dùng để quản lý các dự án Java.
• Một dự án trên Google Cloud. Bạn có thể làm theo các phần Điều kiện tiên quyết và Thiết lập môi trường của Hướng dẫn bắt đầu nhanh.
• Mã của tiện ích bổ sung Google Workspace để gỡ lỗi trong môi trường cục bộ. Chúng tôi sử dụng các tính năng liên kết xem trước từ ví dụ về mã 3p-resources trong kho lưu trữ GitHub googleworkspace/add-ons-samples trong hướng dẫn này cho mục đích minh hoạ.
• Một IDE được thiết lập trong môi trường cục bộ có thể gỡ lỗi. Chúng tôi sử dụng Visual Studio Code IDE và các tính năng gỡ lỗi mặc định của IDE trong hướng dẫn này cho mục đích minh hoạ.
• Tài khoản ngrok.
• Phiên bản mới nhất của gcloud được cài đặt và khởi chạy trong môi trường cục bộ của bạn.

Công khai dịch vụ localhost

Bạn cần kết nối môi trường cục bộ với Internet để tiện ích bổ sung Google Workspace có thể truy cập vào môi trường đó. Ứng dụng ngrok được dùng để chuyển hướng các yêu cầu HTTP được thực hiện đến một URL công khai sang môi trường cục bộ của bạn.

1. Trong trình duyệt trong môi trường cục bộ, hãy đăng nhập vào tài khoản ngrok của bạn.
2. Cài đặt ứng dụng và thiết lập authtoken trong môi trường cục bộ.
3. Tạo một miền tĩnh trong tài khoản ngrok của bạn, miền này được tham chiếu là NGROK_STATIC_DOMAIN trong hướng dẫn của tài liệu này.

Tạo và cài đặt tiện ích bổ sung triển khai

1. Định cấu hình tiện ích bổ sung Google Workspace để gửi tất cả các yêu cầu HTTP đến miền tĩnh của bạn. Tệp triển khai của bạn sẽ có dạng như sau:

   {
     "oauthScopes": [
       "https://www.googleapis.com/auth/workspace.linkpreview",
       "https://www.googleapis.com/auth/workspace.linkcreate"
     ],
     "addOns": {
       "common": {
         "name": "Manage support cases",
         "logoUrl": "https://developers.google.com/workspace/add-ons/images/support-icon.png",
         "layoutProperties": {
           "primaryColor": "#dd4b39"
         }
       },
       "docs": {
         "linkPreviewTriggers": [
           {
             "runFunction": "NGROK_STATIC_DOMAIN",
             "patterns": [
               {
                 "hostPattern": "example.com",
                 "pathPrefix": "support/cases"
               },
               {
                 "hostPattern": "*.example.com",
                 "pathPrefix": "cases"
               },
               {
                 "hostPattern": "cases.example.com"
               }
             ],
             "labelText": "Support case",
             "localizedLabelText": {
               "es": "Caso de soporte"
             },
             "logoUrl": "https://developers.google.com/workspace/add-ons/images/support-icon.png"
           }
         ],
         "createActionTriggers": [
           {
             "id": "createCase",
             "labelText": "Create support case",
             "localizedLabelText": {
               "es": "Crear caso de soporte"
             },
             "runFunction": "$URL2",
             "logoUrl": "https://developers.google.com/workspace/add-ons/images/support-icon.png"
           }
         ]
       },
       "httpOptions": {
         "granularOauthPermissionSupport": "OPT_IN"
       }
     }
   }
   

   Thay thế NGROK_STATIC_DOMAIN bằng miền tĩnh trong tài khoản ngrok của bạn.

2. Đặt dự án trên đám mây của Google Cloud để sử dụng:

   gcloud config set project PROJECT_ID

3. Lấy thông tin đăng nhập mới của người dùng để sử dụng cho Thông tin xác thực mặc định của ứng dụng:

   gcloud auth application-default login

   Thay thế PROJECT_ID bằng mã dự án cho dự án trên đám mây của Google Cloud của ứng dụng.

4. Tạo quá trình triển khai:

   gcloud workspace-add-ons deployments create manageSupportCases \
       --deployment-file=DEPLOYMENT_FILE_PATH

   Thay thế DEPLOYMENT_FILE_PATH bằng đường dẫn đến tệp triển khai của bạn.

5. Cài đặt trình triển khai:

   gcloud workspace-add-ons deployments install manageSupportCases

   

   Hình 2. Tiện ích bổ sung của Google Workspace sẽ gửi tất cả các yêu cầu HTTP đến miền tĩnh. Dịch vụ công khai `ngrok` đóng vai trò là cầu nối giữa tiện ích bổ sung Google Workspace và mã xử lý ứng dụng thực thi cục bộ.

Kiểm thử tiện ích bổ sung của Google Workspace

Bạn có thể triển khai, kiểm thử, gỡ lỗi và tự động tải lại tiện ích bổ sung Google Workspace theo cách cục bộ.

Lưu ý: Tiện ích bổ sung Google Workspace thực thi bằng Cloud Run Functions Framework trong các ví dụ.

Node.js

1. Từ IDE Visual Studio Code được cài đặt trong môi trường cục bộ, hãy làm như sau:

   1. Trong một cửa sổ mới, hãy mở thư mục add-ons-samples/node/3p-resources.

   2. Định cấu hình ứng dụng để chạy cục bộ và gỡ lỗi tự động tải lại bằng cách thêm một phần phụ thuộc và hai tập lệnh vào tệp package.json:

      {
          ...
          "dependencies": {
            ...
            "@google-cloud/functions-framework": "^3.3.0"
          },
          "scripts": {
              ...
              "start": "npx functions-framework --target=createLinkPreview --port=9000",
              "debug-watch": "nodemon --watch ./ --exec npm start"
          }
          ...
      }
      

   3. Trong thư mục gốc, hãy cài đặt ứng dụng:

      npm install

   4. Tạo và định cấu hình một lần khởi chạy có tên Debug Watch để kích hoạt tập lệnh debug-watch bằng cách tạo tệp .vscode/launch.json trong thư mục gốc:

      {
          "version": "0.2.0",
          "configurations": [{
              "type": "node",
              "request": "launch",
              "name": "Debug Watch",
              "cwd": "${workspaceRoot}",
              "runtimeExecutable": "npm",
              "runtimeArgs": ["run-script", "debug-watch"]
          }]
      }
      

   5. Thêm một điểm ngắt để tạm dừng quá trình xử lý yêu cầu HTTP trong tệp index.js, rồi bắt đầu chạy và gỡ lỗi bằng cấu hình Debug Watch đã thêm trước đó. Giờ đây, ứng dụng đang chạy và chờ các yêu cầu HTTP trên cổng 9000.

      

      Hình 3. Ứng dụng đang chạy và chờ yêu cầu HTTP trên cổng 9000.

2. Khởi chạy ứng dụng ngrok trong môi trường cục bộ:

   ngrok http --domain=NGROK_STATIC_DOMAIN 9000

   Thay thế NGROK_STATIC_DOMAIN bằng miền tĩnh trong tài khoản ngrok của bạn. Tất cả yêu cầu hiện được chuyển hướng đến môi trường cục bộ và cổng mà ứng dụng sử dụng.

   

   Hình 4. Thiết bị đầu cuối có máy chủ ngrok đang chạy và chuyển hướng.

3. Giao diện web cũng được ứng dụng ngrok khởi động trên localhost. Bạn có thể theo dõi tất cả hoạt động bằng cách mở nhật ký này trong trình duyệt.

   

   Hình 5. Giao diện web do ứng dụng ngrok lưu trữ không hiển thị yêu cầu HTTP nào.

4. Kiểm thử tiện ích bổ sung Google Workspace bằng cách xem trước một URL trường hợp trong một Google Tài liệu mới bằng tài khoản kiểm thử:

   • Tạo một tệp Google Tài liệu.

     Tạo tài liệu trên Google

   • Nhập đường liên kết sau rồi nhấn enter:

     https://example.com/support/case/?name=Name1&description=Description1&priority=P1
     

   • Nhấp vào liên kết này.

5. Trong Visual Studio Code trong môi trường cục bộ, bạn có thể thấy rằng quá trình thực thi bị tạm dừng tại điểm ngắt đã được đặt.

   

   Hình 6. Quá trình thực thi sẽ tạm dừng tại điểm ngắt đã được đặt.

6. Khi bạn tiếp tục thực thi từ trình gỡ lỗi Visual Studio Code trước khi tiện ích bổ sung Google Workspace hết thời gian chờ, tiện ích bổ sung Google Workspace sẽ hiển thị bản xem trước đường liên kết trong Google Tài liệu từ bộ nhớ đệm.

7. Bạn có thể kiểm tra nhật ký yêu cầu và phản hồi HTTP từ giao diện web do ứng dụng ngrok lưu trữ trong môi trường cục bộ.

   

   Hình 7. Yêu cầu HTTP từ giao diện web do ứng dụng ngrok lưu trữ.

8. Để thay đổi hành vi của ứng dụng, hãy thay thế Case bằng Case: trên dòng 51 của index.js. Khi bạn lưu tệp, nodemon sẽ tự động tải lại ứng dụng bằng mã nguồn đã cập nhật và Visual Studio Code vẫn ở chế độ gỡ lỗi.

   

   Hình 8. Ứng dụng đang chạy và chờ các yêu cầu HTTP trên cổng 9000 khi đã tải thay đổi về mã.

9. Lần này, thay vì nhấp vào đường liên kết và đợi vài giây trong một Google Tài liệu mới, bạn có thể chọn yêu cầu HTTP cuối cùng được ghi lại trên giao diện web do ứng dụng ngrok lưu trữ trong môi trường cục bộ của mình rồi nhấp vào Replay. Giống như lần trước, tiện ích bổ sung Google Workspace của bạn không trả lời vì đang được gỡ lỗi.

10. Khi tiếp tục thực thi từ trình gỡ lỗi Visual Studio Code, bạn có thể thấy từ giao diện web do ứng dụng ngrok lưu trữ trong môi trường cục bộ của mình rằng ứng dụng này tạo ra một phản hồi bằng phiên bản mới nhất của thẻ xem trước.

Python

1. Từ IDE Visual Studio Code được cài đặt trong môi trường cục bộ, hãy làm như sau:

   1. Trong một cửa sổ mới, hãy mở thư mục add-ons-samples/python/3p-resources/create_link_preview.

   2. Tạo một môi trường ảo cho Python env và kích hoạt môi trường đó:

      virtualenv env
      source env/bin/activate

   3. Cài đặt tất cả các phần phụ thuộc của dự án bằng cách sử dụng pip trong môi trường ảo:

      pip install -r requirements.txt

   4. Tạo tệp .vscode/launch.json trong thư mục gốc và định cấu hình một lần khởi chạy có tên Debug Watch để kích hoạt ứng dụng từ mô-đun functions-framework trên cổng 9000 ở chế độ gỡ lỗi trên môi trường ảo env:

      {
          "version": "0.2.0",
          "configurations": [{
              "type": "python",
              "request": "launch",
              "name": "Debug Watch",
              "python": "${workspaceFolder}/env/bin/python3",
              "module": "functions_framework",
              "args": [
                  "--target", "create_link_preview",
                  "--port", "9000",
                  "--debug"
              ]
          }]
      }
      

   5. Thêm một điểm ngắt để tạm dừng quá trình xử lý yêu cầu HTTP trong tệp main.py, rồi bắt đầu chạy và gỡ lỗi bằng cấu hình Debug Watch đã thêm trước đó. Giờ đây, ứng dụng đang chạy và chờ các yêu cầu HTTP trên cổng 9000.

      

      Hình 3. Ứng dụng đang chạy và chờ yêu cầu HTTP trên cổng 9000.

2. Khởi chạy ứng dụng ngrok trong môi trường cục bộ:

   ngrok http --domain=NGROK_STATIC_DOMAIN 9000

   Thay thế NGROK_STATIC_DOMAIN bằng miền tĩnh trong tài khoản ngrok của bạn. Tất cả yêu cầu hiện được chuyển hướng đến môi trường cục bộ và cổng mà ứng dụng sử dụng.

   

   Hình 4. Thiết bị đầu cuối có máy chủ ngrok đang chạy và chuyển hướng.

3. Giao diện web cũng được ứng dụng ngrok khởi động trên localhost. Theo dõi mọi hoạt động bằng cách mở nhật ký trong trình duyệt.

   

   Hình 5. Giao diện web do ứng dụng ngrok lưu trữ không hiển thị yêu cầu HTTP nào.

4. Kiểm thử tiện ích bổ sung Google Workspace bằng cách xem trước một URL trường hợp trong một Google Tài liệu mới bằng tài khoản kiểm thử:

   • Tạo một tệp Google Tài liệu.

     Tạo tài liệu trên Google

   • Nhập đường liên kết sau rồi nhấn enter:

     https://example.com/support/case/?name=Name1&description=Description1&priority=P1
     

   • Nhấp vào liên kết này.

5. Trong Visual Studio Code trong môi trường cục bộ, bạn có thể thấy rằng quá trình thực thi bị tạm dừng tại điểm ngắt đã được đặt.

   

   Hình 6. Quá trình thực thi sẽ tạm dừng tại điểm ngắt đã được đặt.

6. Khi bạn tiếp tục thực thi từ trình gỡ lỗi Visual Studio Code trước khi tiện ích bổ sung Google Workspace hết thời gian chờ, tiện ích bổ sung Google Workspace sẽ hiển thị bản xem trước đường liên kết trong Google Tài liệu từ bộ nhớ đệm.

7. Bạn có thể kiểm tra nhật ký yêu cầu và phản hồi HTTP từ giao diện web do ứng dụng ngrok lưu trữ trong môi trường cục bộ.

   

   Hình 7. Yêu cầu HTTP từ giao diện web do ứng dụng ngrok lưu trữ.

8. Để thay đổi hành vi của ứng dụng, hãy thay thế Case bằng Case: trên dòng 56 của tệp main.py. Khi bạn lưu tệp, Visual Studio Code sẽ tự động tải lại ứng dụng bằng mã nguồn đã cập nhật và vẫn ở chế độ gỡ lỗi.

   

   Hình 8. Ứng dụng đang chạy và chờ các yêu cầu HTTP trên cổng 9000 khi đã tải thay đổi về mã.

9. Lần này, thay vì nhấp vào đường liên kết và đợi vài giây trong một Google Tài liệu mới, bạn có thể chọn yêu cầu HTTP cuối cùng được ghi lại trên giao diện web do ứng dụng ngrok lưu trữ trong môi trường cục bộ của mình rồi nhấp vào Replay. Giống như lần trước, tiện ích bổ sung Google Workspace của bạn không trả lời vì đang được gỡ lỗi.

10. Khi tiếp tục thực thi từ trình gỡ lỗi Visual Studio Code, bạn có thể thấy từ giao diện web do ứng dụng ngrok lưu trữ trong môi trường cục bộ của mình rằng ứng dụng này tạo ra một phản hồi bằng phiên bản mới nhất của thẻ xem trước.

Java

1. Từ IDE Visual Studio Code được cài đặt trong môi trường cục bộ, hãy làm như sau:

   1. Trong một cửa sổ mới, hãy mở thư mục add-ons-samples/java/3p-resources.

   2. Định cấu hình dự án Maven để chạy ứng dụng CreateLinkPreview trên cổng 9000 cục bộ bằng cách thêm trình bổ trợ bản dựng Cloud Functions Framework function-maven-plugin vào tệp pom.xml:

      ...
      <plugin>
          <groupId>com.google.cloud.functions</groupId>
          <artifactId>function-maven-plugin</artifactId>
          <version>0.11.0</version>
          <configuration>
              <functionTarget>CreateLinkPreview</functionTarget>
              <port>9000</port>
          </configuration>
      </plugin>
      ...
      

   3. Giờ đây, bạn có thể khởi chạy ứng dụng này cục bộ ở chế độ gỡ lỗi:

      mvnDebug function:run
      Preparing to execute Maven in debug mode
      Listening for transport dt_socket at address: 8000

   4. Tạo tệp .vscode/launch.json trong thư mục gốc và định cấu hình một lần chạy có tên là Remote Debug Watch, được đính kèm vào ứng dụng đã chạy trước đó trên cổng 8000:

      {
          "version": "0.2.0",
          "configurations": [{
              "type": "java",
              "request": "attach",
              "name": "Remote Debug Watch",
              "projectName": "http-function",
              "hostName": "localhost",
              "port": 8000
          }]
      }
      

   5. Thêm một điểm ngắt tạm dừng quá trình xử lý yêu cầu HTTP trong tệp CreateLinkPreview.java và bắt đầu đính kèm và gỡ lỗi bằng cấu hình Remote Debug Watch đã thêm trước đó. Giờ đây, ứng dụng đang chạy và chờ các yêu cầu HTTP trên cổng 9000.

      

      Hình 3. Ứng dụng đang chạy và chờ yêu cầu HTTP trên cổng 9000.

2. Khởi chạy ứng dụng ngrok trong môi trường cục bộ:

   ngrok http --domain=NGROK_STATIC_DOMAIN 9000

   Thay thế NGROK_STATIC_DOMAIN bằng miền tĩnh trong tài khoản ngrok của bạn. Tất cả yêu cầu hiện được chuyển hướng đến môi trường cục bộ và cổng mà ứng dụng sử dụng.

   

   Hình 4. Thiết bị đầu cuối có máy chủ ngrok đang chạy và chuyển hướng.

3. Giao diện web cũng được ứng dụng ngrok khởi động trên localhost. Theo dõi mọi hoạt động bằng cách mở nhật ký trong trình duyệt.

   

   Hình 5. Giao diện web do ứng dụng ngrok lưu trữ không hiển thị yêu cầu HTTP nào.

4. Kiểm thử tiện ích bổ sung Google Workspace bằng cách xem trước một URL trường hợp trong một Google Tài liệu mới bằng tài khoản kiểm thử:

   • Tạo một tệp Google Tài liệu.

     Tạo tài liệu trên Google

   • Nhập đường liên kết sau rồi nhấn enter:

     https://example.com/support/case/?name=Name1&description=Description1&priority=P1
     

   • Nhấp vào liên kết này.

5. Trong Visual Studio Code trong môi trường cục bộ, bạn có thể thấy rằng quá trình thực thi bị tạm dừng tại điểm ngắt đã được đặt.

   

   Hình 6. Quá trình thực thi sẽ tạm dừng tại điểm ngắt đã được đặt.

6. Khi bạn tiếp tục thực thi từ trình gỡ lỗi Visual Studio Code trước khi tiện ích bổ sung Google Workspace hết thời gian chờ, tiện ích bổ sung Google Workspace sẽ hiển thị bản xem trước đường liên kết trong Google Tài liệu từ bộ nhớ đệm.

7. Bạn có thể kiểm tra nhật ký yêu cầu và phản hồi HTTP từ giao diện web do ứng dụng ngrok lưu trữ trong môi trường cục bộ.

   

   Hình 7. Yêu cầu HTTP từ giao diện web do ứng dụng ngrok lưu trữ.

8. Để thay đổi hành vi của ứng dụng, hãy thay thế Case bằng Case: trên dòng 78 của tệp CreateLinkPreview.java, khởi động lại quy trình mvnDebug và chạy lại Remote Debug Watch để đính kèm lại và khởi động lại quá trình gỡ lỗi.

9. Lần này, thay vì nhấp vào đường liên kết và đợi vài giây trong một Google Tài liệu mới, bạn có thể chọn yêu cầu HTTP cuối cùng được ghi lại trên giao diện web do ứng dụng ngrok lưu trữ trong môi trường cục bộ của mình rồi nhấp vào Replay. Giống như lần trước, tiện ích bổ sung Google Workspace của bạn không trả lời vì đang được gỡ lỗi.

10. Khi tiếp tục thực thi từ trình gỡ lỗi Visual Studio Code, bạn có thể thấy từ giao diện web do ứng dụng ngrok lưu trữ trong môi trường cục bộ của mình rằng ứng dụng này tạo ra một phản hồi bằng phiên bản mới nhất của thẻ xem trước.

Gỡ lỗi từ môi trường từ xa

Trong phần này, bạn sẽ tương tác với tiện ích bổ sung Google Workspace thực thi trên một môi trường từ xa.

Hình 9. Gỡ lỗi từ môi trường từ xa.

Điều kiện tiên quyết

• Tiện ích bổ sung Google Workspace của bạn đã được triển khai và cài đặt.
• Ứng dụng của bạn đang chạy trong môi trường từ xa với trình gỡ lỗi được bật trên một cổng nhất định và được tham chiếu là REMOTE_DEBUG_PORT trong hướng dẫn này.
• Môi trường cục bộ của bạn có thể ssh với môi trường từ xa.
• Một IDE được thiết lập trong môi trường cục bộ của bạn có thể gỡ lỗi. Chúng ta sẽ sử dụng Visual Studio CodeIDE và các tính năng gỡ lỗi mặc định của IDE trong hướng dẫn này cho mục đích minh hoạ.

Kết nối môi trường cục bộ và từ xa

Trong môi trường cục bộ mà bạn muốn bắt đầu kết nối máy khách gỡ lỗi, hãy thiết lập một đường hầm SSH:

ssh -L LOCAL_DEBUG_PORT:localhost:REMOTE_DEBUG_PORT REMOTE_USERNAME@REMOTE_ADDRESS

Thay thế nội dung sau:

• LOCAL_DEBUG_PORT: Cổng gỡ lỗi trong môi trường cục bộ.
• REMOTE_USERNAME: Tên người dùng trong môi trường từ xa.
• REMOTE_ADDRESS: Địa chỉ của môi trường từ xa.
• REMOTE_DEBUG_PORT: Cổng gỡ lỗi trong môi trường từ xa.

Cổng gỡ lỗi trong môi trường cục bộ của bạn hiện được liên kết với cổng gỡ lỗi trong môi trường từ xa.

Bắt đầu gỡ lỗi

Từ IDE Visual Studio Code được cài đặt trong môi trường cục bộ, hãy làm như sau:

1. Trong một cửa sổ mới, hãy mở mã nguồn của ứng dụng.

2. Tạo tệp .vscode/launch.json trong thư mục gốc và định cấu hình một lần chạy có tên là Debug Remote, được đính kèm vào cổng gỡ lỗi trong môi trường cục bộ:

   Node.js

   {
       "version": "0.2.0",
       "configurations": [{
           "type": "node",
           "request": "attach",
           "name": "Debug Remote",
           "address": "127.0.0.1",
           "port": LOCAL_DEBUG_PORT
       }]
   }
   

   Python

   {
       "version": "0.2.0",
       "configurations": [{
           "type": "python",
           "request": "attach",
           "name": "Debug Remote",
           "connect": {
               "host": "127.0.0.1",
               "port": LOCAL_DEBUG_PORT
           }
       }]
   }
   

   Java

   {
       "version": "0.2.0",
       "configurations": [{
           "type": "java",
           "request": "attach",
           "name": "Debug Remote",
           "hostName": "127.0.0.1",
           "port": LOCAL_DEBUG_PORT
       }]
   }
   

   Thay thế LOCAL_DEBUG_PORT bằng cổng gỡ lỗi trong môi trường cục bộ.

3. Thêm một điểm ngắt vào mã nguồn của ứng dụng để tạm dừng quá trình xử lý yêu cầu HTTP, sau đó bắt đầu chạy và gỡ lỗi bằng cấu hình Debug Remote đã thêm trước đó.

   Tương tác với tiện ích bổ sung đã cài đặt của Google Workspace. Tiện ích bổ sung Google Workspace của bạn không phản hồi vì tiện ích này đang được gỡ lỗi tích cực trong IDE Visual Studio Code.

Chủ đề có liên quan

• Tìm hiểu cách truy vấn nhật ký lỗi.