AWS Cloud9 搭配 for AWS SDK Ruby 使用 - AWS SDK 適用於 Ruby
步驟 1：設定您的 AWS 帳戶 以使用 AWS Cloud9步驟 2：設定您的 AWS Cloud9 開發環境步驟 3：設定 AWS SDK for Ruby步驟 4：下載範例程式碼步驟 5：執行範例程式碼

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

AWS Cloud9 搭配 for AWS SDK Ruby 使用

AWS Cloud9 是以 Web 為基礎的整合式開發環境 （IDE），其中包含一組工具，可用於在雲端中編碼、建置、執行、測試、偵錯和發行軟體。您可以使用 for Ruby AWS Cloud9 AWS SDK搭配 來編寫和執行 Ruby 程式碼。 AWS Cloud9 包含程式碼編輯器和終端機等工具。由於 AWS Cloud9 IDE是以雲端為基礎，因此您可以使用網際網路連線的機器，從辦公室、家中或任何地方處理專案。如需 的一般資訊 AWS Cloud9，請參閱 AWS Cloud9 使用者指南 。

請依照下列指示 AWS Cloud9 ，使用 for Ruby AWS SDK設定 ：

步驟 1：設定您的 AWS 帳戶 以使用 AWS Cloud9

若要使用 AWS Cloud9，請從 登入 AWS Cloud9 主控台 AWS Management Console。

注意

如果您使用 AWS IAM Identity Center 進行身分驗證，您可能需要iam:ListInstanceProfilesForRole將必要的 許可新增至IAM主控台中的使用者連接政策。

若要在 AWS 帳戶中設定IAM實體以存取 AWS Cloud9 和登入 AWS Cloud9 主控台，請參閱 AWS Cloud9 使用者指南 中的 團隊設定 AWS Cloud9。

步驟 2：設定您的 AWS Cloud9 開發環境

登入 AWS Cloud9 主控台後，請使用主控台建立 AWS Cloud9 開發環境。建立環境後， AWS Cloud9 請開啟該環境IDE的 。

如需詳細資訊，請參閱 AWS Cloud9 使用者指南 中的在 中建立環境 AWS Cloud9。

注意

當您第一次在主控台中建立環境時，我們建議您選擇 選項，以為環境 （EC2） 建立新執行個體。此選項 AWS Cloud9 會指示 建立環境、啟動 Amazon EC2執行個體，然後將新執行個體連接至新環境。這是開始使用 的最快方法 AWS Cloud9。

如果終端機尚未在 中開啟IDE，請將其開啟。在 的選單列上IDE，選擇 Window， New Terminal 。您可以使用終端機視窗來安裝工具和建置應用程式。

步驟 3：設定 AWS SDK for Ruby

AWS Cloud9 開啟開發環境IDE的 後，請使用終端機視窗在您的環境中設定 AWS SDK for Ruby。

您可以像任何 Ruby AWS SDK寶石一樣安裝 for Ruby。寶石可在 取得RubyGems。for Ruby AWS SDK設計為模組化，並由 分隔 AWS 服務。安裝整個aws-sdk寶石是大型的，可能需要一小時的時間。

建議您只為您 AWS 服務 使用的 安裝寶石。這些名稱命名為 ，aws-sdk-service_abbreviation完整清單位於 for Ruby README 檔案的 AWS SDK支援服務資料表中。例如，用於與 Amazon S3 服務連接的寶石可直接在 上取得aws-sdk-s3。

Ruby 版本管理員

我們建議您使用 Ruby 版本管理員，例如下列，而不是使用系統 Ruby：

例如，如果您使用的是 Amazon Linux 2 作業系統，下列命令可用來更新 RVM、列出可用的 Ruby 版本，然後選擇您想要使用 for Ruby 進行開發的 AWS SDK版本。Ruby 最低必要版本為 2.3。

$ rvm get head
$ rvm list known
$ rvm install ruby-3.1.3
$ rvm --default use 3.1.3

搭售商

如果您使用 Bundler ，下列命令會 AWS SDK為 Amazon S3 安裝 for Ruby 寶石：

  1. 安裝 Bundler 並建立 Gemfile：

    $ gem install bundler
$ bundle init

  2. 開啟建立的 Gemfile，並為您的程式碼將使用的每個 AWS 服務寶石新增一gem行。若要遵循 Amazon S3 範例，請將以下行新增至檔案底部：

    gem "aws-sdk-s3"

  3. 儲存 Gemfile。

  4. 安裝 中指定的相依性Gemfile：

    $ bundle install

步驟 4：下載範例程式碼

使用終端機視窗，將 for Ruby AWS SDK的範例程式碼下載到 AWS Cloud9 開發環境中。

若要將正式 AWS SDK文件中使用的所有程式碼範例下載到您環境的根目錄，請執行下列命令：

$ git clone https://github.com/awsdocs/aws-doc-sdk-examples.git

for Ruby 的 AWS SDK程式碼範例位於 ENVIRONMENT_NAME/aws-doc-sdk-examples/ruby目錄，其中 ENVIRONMENT_NAME是開發環境的名稱。

若要遵循使用 Amazon S3 範例，建議您從程式碼範例 開始ENVIRONMENT_NAME/aws-doc-sdk-examples/ruby/example_code/s3/bucket_list.rb。使用終端機視窗導覽至s3目錄並列出檔案。

$ cd aws-doc-sdk-examples/ruby/example_code/s3
$ ls

若要在 中開啟 檔案 AWS Cloud9，您可以bucket_list.rb直接在終端機視窗中按一下 。

步驟 5：執行範例程式碼

若要在 AWS Cloud9 開發環境中執行程式碼，請選擇頂端選單列中的執行按鈕。 AWS Cloud9 會自動偵測.rb副檔名，並使用 Ruby Runner 執行程式碼。如需在 中執行程式碼的詳細資訊 AWS Cloud9，請參閱 AWS Cloud9 使用者指南 中的執行程式碼。

在下列螢幕擷取畫面中，記下這些基本區域：

  • 1：執行。執行按鈕位於頂端選單列。這會開啟結果的新索引標籤。

    注意

    您也可以手動建立新的執行組態。在選單列上，選擇 Run (執行)、Run Configurations (執行組態)、New Run Configuration (新增執行組態)。

  • 2：Command. 會將路徑和檔案名稱 AWS Cloud9 填入您執行的檔案。如果您的程式碼預期任何命令列參數都會傳入，則可以與透過終端機視窗執行程式碼時相同的方式將這些參數新增至命令列。

  • 3：Runner. AWS Cloud9 偵測您的副檔名是 .rb，然後選取 Ruby Runner 來執行程式碼。

從 AWS Cloud9 IDE的頂端選單列中選擇執行，會開啟新的索引標籤，並填入命令方塊，以及已選取的 Ruby 執行器。

從執行中的程式碼產生的任何輸出都會顯示在 索引標籤中。

若要測試許多其他 Amazon S3 操作，請查看 上的AWS 程式碼範例儲存庫 GitHub。