

# AWS Toolkit for JetBrains入門
<a name="getting-started"></a>

AWS Toolkit for JetBrains 讓您可直接在整合式開發環境 (IDE) 中使用 AWS 服務和資源。

若要幫助您上手，下列主題將逐步引導您完成安裝、設定和配置 AWS Toolkit for JetBrains 的程序。

**Topics**
+ [安裝 AWS 工具組](setup-toolkit.md)
+ [安裝自訂組建和發行版本](setup-toolkit-eap.md)
+ [Navigation (導覽)](navigation.md)
+ [連接到 AWS](account-connect.md)
+ [AWS 區域](setup-region.md)
+ [HTTP Proxy 設定](setup-http-proxy.md)

# 安裝 AWS Toolkit for JetBrains
<a name="setup-toolkit"></a>

您可以從 IDE 中的 JetBrains Marketplace 下載、安裝和設定 AWS Toolkit for JetBrains。或者，您也能使用網頁瀏覽器導覽至 [AWS Toolkit for JetBrains Marketplace](https://plugins.jetbrains.com/plugin/11349-aws-toolkit) 清單，下載最新的 AWS Toolkit for JetBrains 安裝檔案。

 下列各節說明如何直接從 JetBrains IDE 安裝和設定 AWS Toolkit for JetBrains。

## 從 JetBrains IDE 安裝 AWS Toolkit
<a name="setup-toolkit-intsall"></a>

若要直接從您偏好的 JetBaibrains IDE 下載並安裝 AWS Toolkit for JetBrains，請完成下列程序。

1. 在 JetBrains 主選單中，開啟您的**偏好設定**選單 (展開**檔案**並選擇**設定**，適用於 Windows 使用者)。

1. 從**偏好**/**設定**選單中，選擇**外掛程式**來開啟**外掛程式**選單。

1. 在**外掛程式**選單導覽中，選擇 **Marketplace** 來開啟 JetBrains Plugin **Marketplace**。

1. 在提供的搜尋欄位中輸入 **AWS Toolkit**。

1. 找到 **AWS Toolkit** 外掛程式項目，選擇項目標題旁邊的綠色**安裝**按鈕。

1. 接受**第三方外掛程式隱私聲明**以繼續安裝程序。

1. 安裝完成後，JetBrains 會提示您重新啟動 IDE。

# 安裝 AWS Toolkit for JetBrains 早期存取計劃 (EAP) 和自訂組建
<a name="setup-toolkit-eap"></a>

AWS Toolkit for JetBrains 的早期存取計劃 (EAP) 組建包含新功能和實驗功能的預覽。

若要設定使用工具組的 EAP 組建，請完成下列程序：

1. 在 JetBrains 主選單中，開啟您的**偏好設定**選單 (展開**檔案**並選擇**設定**，適用於 Windows 使用者)。

1. 從**偏好**/**設定**選單中，選擇**外掛程式**來開啟**外掛程式**選單。

1. 在**外掛程式**選單導覽區中，展開**設定 (管理儲存庫、設定 Proxy 或從磁碟安裝外掛程式)** 圖示，然後選擇**管理外掛程式庫儲存庫**。

1. 在**管理外掛程式庫**選單中選擇 **\$1 (新增)** 圖示，然後在**適用於 AWS Toolkit 的 EAP 儲存庫**欄位中輸入 **https://plugins.jetbrains.com/plugins/eap/aws.toolkit**。

1. 選擇**確定**以啟動 EAP 安裝。

1. 安裝完成後，JetBrains 會提示您重新啟動 IDE。

## 移除 AWS Toolkit for JetBrains EAP 和自訂儲存庫參考
<a name="setup-toolkit-eap-remove"></a>

您可能需要移除 EAP 或自訂儲存庫參照，才能使用特定版本的 AWS Toolkit for JetBrains。若要移除儲存庫參考，請完成下列程序。

**注意**  
完成此程序後，可能仍需解除安裝 AWS Toolkit for JetBrains 的目前版本，才能更新或安裝不同版本。

**移除 EAP 儲存庫參考**

1. 在 JetBrains 主選單中，開啟您的**偏好設定**選單 (展開**檔案**並選擇**設定**，適用於 Windows 使用者)。

1. 從**偏好**/**設定**選單中，選擇**外掛程式**來開啟**外掛程式**選單。

1. 在**外掛程式**選單導覽區中，展開**設定 (管理儲存庫、設定 Proxy 或從磁碟安裝外掛程式)** 圖示，然後選擇**管理外掛程式庫儲存庫**。

1. 在**管理外掛程式儲存庫**選單中，選擇 **- (移除)** 圖示並確認移除。

# 導覽 AWS Toolkit for JetBrains
<a name="navigation"></a>

下列主題說明 AWS Toolkit for JetBrains 的基本位置和元件。

**Topics**
+ [從 JetBrains 檢視工具組](#w7aab9c13b7)
+ [AWS Explorer](#w7aab9c13b9)
+ [連接到 AWS](#w7aab9c13c11)

## 從 JetBrains 檢視工具組
<a name="w7aab9c13b7"></a>

若要在 JetBrains IDE 中檢視工具組，請完成下列步驟：

1. 在 JetBrains IDE 中，使用 JetBrains 左下角的**作用中工具列**圖示，展開**作用中工具列**。

1. 在**作用中工具列**中選擇 **AWS 工具箱**。

1. 此時 AWS Toolkit for JetBrains 會在**作用中工具列**視窗中打開。

![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/navigation-open-toolkit-2023-06-01.gif)


## AWS Explorer
<a name="w7aab9c13b9"></a>

您的 AWS 服務和資源可透過 AWS Toolkit for JetBrains Explorer 存取。

**注意**  
完成設定身分驗證並連線到您的 AWS 帳戶後，AWS Explorer 才會顯示您的 AWS 服務和資源。  
如需身分驗證和 AWS Toolkit for JetBrains 的其他資訊，請參閱本使用者指南中的[身分驗證與存取](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/auth-access.html)目錄。  
如需從 AWS Toolkit for JetBrains 連線到 AWS 帳戶的其他資訊，請參閱本使用者指南中的[連線至 AWS](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/account-connect.html) 主題。

若要從 AWS Toolkit for JetBrains Explorer 檢視您的 AWS 服務和資源：

1. 從 AWS Toolkit for JetBrains 選擇 **Explorer** 索引標籤以檢視與您的帳戶和區域相關聯的 AWS 服務。

1. 選取服務以展開資源清單。

1. 開啟資源的內容選單 (按一下滑鼠右鍵)，以查看修改資源的功能清單。

![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/navigation-view-resource-2023-06-01.gif)


## 連接到 AWS
<a name="w7aab9c13c11"></a>

連線設定位於 AWS Toolkit for JetBrains 連線窗格的**省略符號圖示**選單中。

**注意**  
如需從 AWS Toolkit for JetBrains 連線到 AWS 帳戶的其他資訊，請參閱本使用者指南中的[連線至 AWS](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/account-connect.html) 主題。

![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/toolkit-for-jetbrains/latest/userguide/images/navigation-view-connection-2023-06-01.png)


# 將 AWS Toolkit for JetBrains 連線到您的 AWS 帳戶
<a name="account-connect"></a>

大多數 Amazon Web Services (AWS) 和資源都須透過 AWS 帳戶管理。不需要 AWS 帳戶就能使用 AWS Toolkit for JetBrains，但是在沒有連線的情況下工具組的功能會受到限制。

如果您先前已設定 AWS 帳戶，且已透過另一個 AWS 服務 (如 AWS Command Line Interface) 進行認證，AWS Toolkit for JetBrains 就會自動偵測您的憑證並引導您完成連線程序。

如果您初次使用 AWS 或尚未建立帳戶，那麼需執行 3 個主要步驟來將 AWS Toolkit for JetBrains 連線至您的 AWS 帳戶：

1. **註冊 AWS 帳戶**：您可以在 [AWS 註冊](https://portal.aws.amazon.com/billing/signup#/start/email)入口網站註冊 AWS 帳戶。如需設定新 AWS 帳戶的詳細資訊，請參閱《AWS 設定使用者指南》**中的[概觀](https://docs.aws.amazon.com/SetUp/latest/UserGuide/setup-overview.html)主題。

1. **設定身分驗證**：有 3 種主要方法可以從 AWS Toolkit for JetBrains 使用您的 AWS 帳戶驗證身分。若要進一步了解這些方法，請參閱本使用者指南中的[身分驗證與存取](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/auth-access.html)主題。

1. **從 AWS Toolkit for JetBrains 使用您的 AWS 帳戶驗證身分**：建立 AWS 帳戶並設定身分驗證之後，完成下一節所說明*從 AWS Toolkit for JetBrains 連線至 AWS* 的程序，即可將 AWS Toolkit for JetBrains 連線至您的 AWS 帳戶。

## 從 AWS Toolkit for JetBrains 連線至 AWS
<a name="account-connect-authenticate"></a>

完成以下步驟，從 AWS Toolkit for JetBrains 透過您的 AWS 帳戶使用現有 IAM Identity Center 憑證進行驗證。

**注意**  
此程序會在您偏好的網頁瀏覽器中啟動 AWS IAM Identity Center 入口網站。每當您的憑證過期，都必須重複此程序以更新 AWS 帳戶和 AWS Toolkit for JetBrains 之間的連線。

1. 在 AWS Toolkit for JetBrains 中選擇 **...** (省略符號) 圖示，展開 **AWS 連線設定**選單。

1. 在 **AWS 連線設定**選單中，選擇**新增連線...** 以開啟 **AWS Toolkit: 新增連線**對話方塊。

1. 在 **AWS Toolkit: 新增連線**對話方塊中，選取您要驗證的連線選項，然後選擇**連線**以繼續。
**注意**  
如需針對 AWS Toolkit for JetBrains 為 AWS 帳戶設定驗證方法的資訊，請參閱本使用者指南中的[身分驗證與存取](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/auth-access.html)主題。

1. 選擇驗證方法後，請按照畫面上的提示操作，將 AWS Toolkit for JetBrains 連線至您的 AWS 帳戶，JetBrains 會在設定程序完成時通知您。

# 設定 AWS Toolkit for JetBrains 的 AWS 區域
<a name="setup-region"></a>

AWS 區域指定了管理您 AWS 資源的位置。當您從 AWS Toolkit for JetBrains 連線到 AWS 帳戶時，系統會偵測您的預設 AWS 區域，並自動顯示在 AWS Explorer中

以下各節說明如何從 AWS Toolkit for JetBrains Explorer 檢視和變更區域。

## 檢視目前 AWS 區域
<a name="setup-region-current-region"></a>

若要查看目前已選取哪一個 AWS 區域，請完成以下步驟。

1. 在 AWS Explorer 中，選擇**設定**圖示開啟**顯示選項選單**。

1. 在**顯示選項選單**中，展開 **AWS連線設定**顯示您帳戶可用的 AWS 區域清單。

1. 您目前的 AWS 區域會顯示**核取記號**圖示 (位於區域名稱旁邊)。

## 變更 AWS 區域
<a name="setup-region-switch-region"></a>

若要變更目前的 AWS 區域，請完成以下步驟。

1. 在 AWS Explorer 中，選擇**設定**圖示開啟**顯示選項選單**。

1. 在**顯示選項選單**中，展開 **AWS 連線設定**顯示 AWS 區域清單。

1. 從清單中選擇您要連線的 AWS 區域。
**注意**  
如果您沒有看到想要連線的區域，請選擇**所有區域**開啟所有 AWS 區域的完整清單。

# 為 AWS Toolkit for JetBrains 設定 HTTP Proxy
<a name="setup-http-proxy"></a>

為 AWS Toolkit for JetBrains 設定 HTTP Proxy 的程序是透過 JetBrains 整合式開發環境 (IDE) 處理。若要了解如何設定 HTTP Proxy 的詳細資訊，請從以下清單中選擇您的 JetBrains IDE。
+ **CLion**：請參閱 CLion 說明網站上的[設定 HTTP Proxy](https://www.jetbrains.com/help/clion/configuring-http-proxy.html)。
+ **GoLand** ：請參閱 GoLand 說明網站上的 [HTTP Proxy](https://www.jetbrains.com/help/go/settings-http-proxy.html)。
+ **IntelliJ IDEA**：請參閱 IntelliJ IDEA 說明網站上的 [HTTP Proxy](https://www.jetbrains.com/help/idea/settings-http-proxy.html)。
+ **WebStorm**：請參閱 WebStorm 說明網站上的 [HTTP Proxy](https://www.jetbrains.com/help/webstorm/settings-http-proxy.html)。
+ **JetBrains Rider**：請參閱 JetBrains Rider 說明網站上的[設定 HTTP Proxy](https://www.jetbrains.com/help/rider/Configuring_HTTP_Proxy.html)。
+ **PhpStorm**：請參閱 PhpStorm 說明網站上的 [HTTP Proxy](https://www.jetbrains.com/help/phpstorm/settings-http-proxy.html)。
+ **PyCharm**：請參閱 PyCharm 說明網站上的 [HTTP Proxy](https://www.jetbrains.com/help/pycharm/settings-http-proxy.html)。
+ **RubyMine**：請參閱 RubyMine 說明網站上的 [HTTP Proxy](https://www.jetbrains.com/help/ruby/settings-http-proxy.html)。