Watson Studio 延伸 (適用於 Visual Studio Code

當您將 Watson Studio 延伸新增至 Visual Studio Code時，可以直接從 Visual Studio Code 編輯器連接至 Cloud Pak for Data 叢集、啟動及停止執行時期、編輯 Watson Studio Git型專案內的檔案，以及在 Cloud Pak for Data 執行時期內執行及除錯程式碼。

連線會透過受叢集標準鑑別設定保護的安全 Web Socket 通道來引導通訊。 Web Socket 通道支援遠端編輯程式碼或在遠端執行時期執行及除錯程式碼所需的 SSH 通訊協定子集。

服務
依預設無法使用 Watson Studio 服務。管理者必須在 IBM Cloud Pak for Data 平台上安裝此服務。若要判定是否已安裝服務，請開啟服務型錄，並檢查服務是否已啟用。

必要服務
Watson Studio 加上適當的執行時期服務

必要條件

下載並安裝 Watson Studio 延伸之前，請確定您的管理者已啟動 Visual Studio Code 支援。如需詳細資料，請參閱 Watson Studio 服務的後置安裝作業。

Watson Studio 延伸已使用 Visual Studio Code 1.72.2 進行測試，並且至少需要 Visual Studio Code 1.69.0 或更新版本才能運作。雖然 1.72.2 之前的版本應該可以運作，但請嘗試讓 Visual Studio Code 保持最新的最新可用版本。

專案類型

只有 Git型專案可以與 Visual Studio Code 延伸規格整合。

資產類型

您可以新增至 Watson Studio 專案的所有資產。如需詳細資料，請參閱將資料新增至專案。

資料格式

Git型專案中的所有資產。

限制

只有 Git型專案可以與 Visual Studio Code 延伸規格整合。在 Visual Studio Code內使用專案之前，請先從 CPD 使用者介面配置 Git 整合。如需相關資訊，請參閱存取 Git 儲存庫。
支援所有 JupyterLab 預設環境，但 Spark 型環境及基於 Spark 的自訂環境除外。
如果在叢集上啟用 FIPS ，則 Visual Studio Code 整合無法運作。
當您從 Microsoft 使用正式 Python 延伸時，目前不支援執行 Jupyter Notebook。

設定步驟

若要設定 Visual Studio Code的 Watson Studio 延伸，請執行下列動作:

下載延伸
安裝延伸規格
配置延伸
在機器上設定 SSH
選用項目: 重新安裝其他延伸

適當地設定 Watson Studio 延伸之後，您可以使用它來執行下列動作:

透過 SSH 通訊協定連接至 Cloud Pak for Data 叢集中的執行時期
中斷與 Cloud Pak for Data 叢集中執行時期的連線
停止 Cloud Pak for Data 叢集中執行中的執行時期

下載 Watson Studio 延伸 for Visual Studio Code

若要下載 Visual Studio Code的 Watson Studio 延伸規格，請使用此鏈結: Watson Studio 延伸規格。

安裝 Watson Studio 延伸 for Visual Studio Code

若要安裝 Watson Studio 延伸 for Visual Studio Code，請執行下列動作:

從 Visual Studio Code中，開啟「延伸」功能表，按一下「其他選項 (...)」，然後選取 Install from VSIX。
選取下載的 watson-studio.vsix 檔案，然後按一下安裝。
選用項目: 如果您想要能夠直接從 Visual Studio Code內存取執行時期，請在 Visual Studio Code中安裝遠端 SSH 延伸規格。延伸可以在 Microsoft Marketplace中找到。
附註: 如果您不想安裝「遠端 SSH 延伸」，則必須在機器上安裝不同的 SSH 用戶端。無法在沒有 SSH 用戶端的情況下從 Visual Studio Code 內連接至執行時期。

從第 6 版檔案安裝延伸

配置 Watson Studio 延伸 for Visual Studio Code

若要配置 Watson Studio 延伸 for Visual Studio Code，請執行下列動作:

從 Visual Studio Code中，開啟設定功能表。或者，使用 Cmd/Ctrl + Shift + P 組合鍵開啟指令選用區，然後搜尋 Settings UI。
選取 Settings UI。
設定必要的參數。請參閱此表格:

參數	說明
`watsonstudio.host`	Cloud Pak for Data 叢集的主機名稱。當您登入 Cloud Pak for Data時，可以在瀏覽器的位址列中找到它。例如，`cpd.xxx.xxx.xxx.com`。
`watsonstudio.userName`	用來登入 Cloud Pak for Data 的使用者名稱
`watsonstudio.localPort`	要在本端接聽的埠 (預設值: `5681`)
`watsonstudio.localHost`	遠端 SSH 所連接的 SSH 主機。它可以是 SSH 用戶端配置檔中指定的任何主機。請參閱對 Watson Studio使用個別 SSH 金鑰。在 SSH 用戶端配置中配置的 `HostName` 必須一律指向本端主機及 `localPort`中指定的埠。這可讓您使用自己的 SSH 設定，即特定的私密金鑰。如果您使用預設 SSH 金鑰 (`id_rsa`) ，請勿變更此設定: `127.0.0.1`。
`watsonstudio.publicKeyPath`	SSH 連線的公開金鑰檔路徑
`watsonstudio.verifySSL`	選用項目: 是否驗證 SSL 連線的憑證。預設值： `true`
`watsonstudio.logLevel`	延伸的記載層次
`watsonstudio.storeApiKeyInKeychain`	是否將已加密的 Cloud Pak for Data API 金鑰儲存在作業系統金鑰鏈中。預設值: `true`。如果停用此選項，則 API 金鑰僅在現行階段作業期間儲存在記憶體中。當您重新啟動 Visual Studio Code 實例時，必須重新輸入 API 金鑰。

配置延伸

在機器上設定 SSH

您可以使用現有的 SSH 金鑰組來使用 Watson Studio Visual Studio Code 延伸。如果要檢查您是否已配置 SSH 金鑰組，請執行下列動作:

在 Windows 型機器上:
請檢查您的起始目錄是否包含 .ssh 目錄，或執行 dir "%USERPROFILE%/.ssh"。

在 MacOS 及 Linux型機器上:
檢查 ~/.ssh 目錄。

如果您找到的唯一金鑰是預設金鑰，則仍然可以將它與 Watson Studio Visual Studio Code 延伸規格搭配使用。如果您不想要使用預設 SSH 金鑰，則可以選擇性地為 Watson Studio建立個別 SSH 金鑰。

如果您還沒有任何 SSH 金鑰組，請先產生它們，然後再開始使用延伸。

附註: 目前僅支援 RSA 金鑰，且 SSH 金鑰必須採用 OpenSSH 格式。

如需如何產生 SSH 金鑰組的詳細資料，請參閱在 MacOS 和 Linux上產生 SSH 金鑰組及在 Windows 上產生 SSH 金鑰組。

在 MacOS 和 Linux 上產生 SSH 金鑰組

如果要在 MacOS 和 Linux上產生 SSH 金鑰組，請執行下列動作:

開啟終端機
鍵入下列指令:
```
ssh-keygen -t rsa -N ""
```

當您產生金鑰組時，請在延伸的 watsonstudio.publicKeyPath 設定中指定公開金鑰的位置。請參閱配置延伸。

在 Windows 上產生 SSH 金鑰組

若要在 Windows 上產生 SSH 金鑰組:

在已啟用 OpenSSH 用戶端特性的 Windows 10 或更新版本上:

開啟新的 cmd 命令提示字元，並使用 ` ssh-keygen 公用程式。
鍵入下列指令:
```
ssh-keygen -t rsa -N ""
```

如果您使用較舊的 Windows 版本:

安裝協力廠商工具 (例如 PuTTY) 以產生 SSH 金鑰。
如果您使用 PuTTY，請使用 puttygen 公用程式來產生 SSH 金鑰組。

** Note:** PuttyGen 依預設不會產生 OpenSSH 金鑰。若要匯出 OpenSSH 金鑰，請轉換金鑰: 選取「轉換」->「匯出 OpenSSH 金鑰」。

當您產生金鑰組時，請在延伸的 watsonstudio.publicKeyPath 設定中指定公開金鑰的位置。請參閱配置延伸。

選用項目: 對 Watson Studio 使用個別 SSH 金鑰

若要鑑別， SSH 會在 .ssh 目錄中搜尋名為 id_rsa 的預設金鑰。如果您不想要使用此預設金鑰，則可以為 Watson Studio定義個別金鑰。若要將特定 SSH 金鑰用於 Watson Studio，請執行下列動作:

在 ~/.ssh/config下新增項目至 SSH 配置:

Host cpdenv
    HostName localhost
    Port 5681 # Same port as watsonstudio.localPort
    IdentityFile ~/.ssh/id_cpd_rsa # Path to your private key

在 Watson Studio 延伸設定中，於 watsonstudio.localHost下輸入主機。例如，cpdenv。

選用項目: 重新安裝其他延伸

您的本端 Visual Studio Code 使用者介面正在連接執行時期中執行的 Visual Studio Code 伺服器，因此必須重新安裝大部分延伸規格。若要這樣做，請開啟延伸標籤，並針對您要在執行時期中可用的延伸選取 Install in SSH 。

在 SSH 選項中安裝

連接至執行時期

必要條件:
建議您要連接的執行時期所使用的環境至少具有 2 個 CPU 及 4 GB 記憶體。

由於必須安裝 Visual Studio Code Server 組件，與執行時期的第一個連線需要較長的時間。由相同使用者建立的後續連線會更快。

當您連接至使用自簽 CA 的 Cloud Pak for Data 叢集時，請將憑證包含在作業系統的憑證儲存庫中 (由 Visual Studio Code存取)。否則，會拒絕連線。或者，您可以停用 Use SSL/Verify SSL 選項，以停用 SSL 憑證的驗證。不建議使用此方法。

若要連接至執行時期，請執行下列動作:

使用 Cmd/Ctrl + Shift + P 組合鍵開啟指令選用區，然後搜尋 Watson Studio: Connect to Runtime。
選取 Watson Studio: Connect to Runtime。
選取您要使用的專案。
在每個階段作業的第一個連線上指定 Cloud Pak for Data API 金鑰。
選取執行時期要使用的環境。
當執行時期啟動並建立安全通道時，您可以透過下列方式連接至執行時期:
- 使用蹦現視窗中顯示的 SSH 指令。
  重要事項: 您必須保持此 Visual Studio Code 視窗開啟，否則會關閉與執行時期的連線。
- 如果您已安裝「遠端 SSH 延伸規格」，則可以使用 開啟執行時期 按鈕來連接。如果您使用遠端 SSH 延伸規格，建議您安裝 Visual Studio Code 的 Python 延伸。

選用項目: 將憑證新增至 Windows 上作業系統的憑證儲存庫

若要將憑證新增至 Windows 憑證儲存庫，請遵循下列步驟:

開啟命令提示字元。
執行 certmgr。
在 Trusted Root Certification Authorities > Certificates中新增憑證。

中斷執行時期的連線

若要與 Cloud Pak for Data 叢集中的執行時期中斷連線 (關閉執行時期與電腦之間的安全通道) ，請執行下列動作:

使用 Cmd/Ctrl + Shift + P 組合鍵開啟指令選用區，然後搜尋 Watson Studio: Disconnect from Runtime。
選取 Watson Studio: Disconnect from Runtime。即會出現 Successfully disconnected from runtime 訊息。

停止執行時期

執行時期會繼續在叢集上執行，除非您使用 Cloud Pak for Data 使用者介面或 Visual Studio Code 延伸來停止它。在停止執行時期之前，請確保先中斷與執行時期的連線。請參閱從執行時期中斷連接。停止執行時期而不先切斷執行時期的連線，會導致 502 錯誤。

若要停止 Cloud Pak for Data 叢集中執行中的執行時期，請執行下列動作:

使用 Cmd/Ctrl + Shift + P 組合鍵開啟指令選用區，然後搜尋 Watson Studio: Stop Runtime。
選取 Watson Studio: Stop Runtime。
選取您要停止的執行時期。

常見問題 (FAQ) 和常見問題

在使用「遠端 SSH 延伸」時，我失去與執行時期的連線。如何重新連接?

如果您失去與執行時期的連線，請使用 Watson Studio: Connect to Runtime 指令重新連接至執行時期。如需詳細資料，請參閱連接至執行時期。重新建立執行時期與本端 PC 之間的連線之後，請按「遠端 SSH」視窗中的 重新載入 按鈕，以透過遠端 SSH 重新連接。

失去連線視窗

我無法從我的 Mac 電腦連接至 Visual Studio Code 。如何修正此問題?

從 8.8版開始， Open SSH 與 Cloud Pak for Data 4.6.0不相容。這表示當您使用 MacOS 13.0.1 版 (或更新版本) 時，無法連接至 4.6.0 叢集。若要解決此問題，請升級至 Cloud Pak for Data 4.6.1 版或更新版本。可能的暫行解決方法 (不建議): 若要在具有 Open SSH 8.8 版或更新版本的機器上連接至 Cloud Pak for Data 4.6.0 叢集，請鍵入下列指令:

ssh -o HostKeyAlgorithms=+ssh-rsa 127.0.0.1 -p 5681

附註:
如果無法重新連接，請嘗試增加機器上的遠端 SSH 逾時值。

增加 SSH 逾時

當我嘗試連接至 Cloud Pak for Data 叢集時，收到 SSL 錯誤

在 Mac 上將憑證新增至作業系統的憑證儲存庫

移至 Finder > Applications > Utilities > Keychain Access。
選取 System。
檢查您的自簽 CA 憑證是否在清單上。如果您的憑證不在清單中，若要新增它，請執行下列動作:
1. 使用 File -> Import items匯入憑證。
2. 匯入您的憑證時，按兩下憑證以開啟它，然後選取 Trust -> When using this certificate -> Always trust。

如需網路及 Proxy 設定的其他問題，請參閱官方 Visual Studio Code 文件。

進一步瞭解

上層主題: 分析資料及建置模型