メインコンテンツまでスキップ

Bitrise AMI用のEC2インスタンスの起動

独自のAmazon EC2 MacまたはLinuxインスタンスでBitriseエージェントを実行するために、専用のBitrise Amazon Machine Image(AMI)を提供しています。

このドキュメントでは、Amazon EC2コンソールUIでインスタンスを起動する手順について説明します。このプロセスには3つの主なフェーズがありますが、一度で完了できます。

  1. EC2のMacまたはLinuxインスタンスを準備する。
  2. AWSでインスタンスを設定する。
  3. インスタンスをBitriseのworkspaceに接続する。

EC2のMacとLinuxインスタンスの準備Click to copy link​

  1. ランナープールを設定し、認証に必要なトークンをコピーします。
  2. Bitriseでランナープールを追加する際に、トークンを取得します。
  3. AWS Secrets Manager シークレットを作成し、そのシークレットにトークンを保存します。
  4. IAMロールを作成し、シークレットを読み取る権限を付与します。このロールはEC2インスタンスにアタッチする必要があります。
  5. AWSで専用ホストを割り当てます。自動生成されたホストIDが必要になります。

インスタンスの設定Click to copy link​

  1. AWS Marketplaceページに移動し、左側でManage subscriptionを選択します。

  2. 必要なAMIを選択し、Launch new instanceを選択します。

    aws-markplace-amis.png

  3. ソフトウェアバージョンとリージョンが正しいことを確認し、Continue to launch through EC2をクリックします。

  4. Launch an instanceページで必須項目を入力します:

    Name and tags セクション:

    • Name: インスタンスの名前です。

    Instance type セクション:

    • Instance type: サポートされているタイプは、mac-m4.metal、mac-m4pro.metal、mac2.metal、mac2-m2.metal、mac2-m2pro.metalです。

      専用ホストタイプ

      選択したinstance typeは、専用ホストのタイプと一致している必要があります。

    Key pair (login) セクション:

    • Key pair name - required:

    Network settings セクション - Editをクリックして設定を変更します:

    • VPC - required: ドロップダウンメニューから仮想プライベートクラウドを選択します。
    • Subnet: ドロップダウンメニューから使用するサブネットを選択するか、No preferenceのままにします。
    • Firewall (security groups): 新しいセキュリティグループを作成するか、既存のものを選択します。

    Configure storage セクション:

    • ストレージボリュームのサイズをギガバイト単位で設定します:

      ベアメタルmacOS AMIの場合、最小値は400GBですが、450GB以上を推奨します。

      仮想化macOS AMIの場合、ホストあたり1台のVMでは700GB、ホストあたり2台のVMでは1000GBを推奨します。

      ディスクサイズの増加

      デフォルトの400GBからディスクサイズを増やす必要がある場合は、macOSが割り当てられたストレージをすべて使用できるようにディスクを再パーティション化してください。これは、インスタンスのセットアップ時にAdvanced detailsセクションのUser dataにスクリプトを追加することで行えます。詳しくはMacインスタンスでのディスクサイズの増加を参照してください。

    • ドロップダウンメニューからルートボリュームタイプを選択します。

      ストレージタイプ

      少なくともgp3のルートボリュームを使用することを推奨します。IOPSは高いほど良好です。

    Advanced details セクション:

    • Tenancy: ドロップダウンメニューからDedicated host - launch this instance on a dedicated HostオプションをSelect。
    • Target host: ドロップダウンメニューからHost IDオプションをSelect。
    • Tenancy host ID: 事前に作成した専用ホストのホストIDを選択します。

EC2のMacまたはLinuxインスタンスをBitriseのWorkspaceに接続するClick to copy link​

  1. インスタンスが以下のエンドポイントにアクセスできることを確認します:

  2. インスタンスのUser dataを変更し、AWS Secrets Managerで作成したSecretを使用してBitriseランナーを起動するコマンドを追加します:

    important

    EC2 Macインスタンス用にuser dataスクリプトを変更する場合は、スクリプトの先頭に空白がないことを確認してください。最初の行は必ず#!/bin/bashである必要があります。この行の前に空白があると、インスタンスが動作しません。

    TOKEN=$(aws secretsmanager get-secret-value --secret-id MY_SECRET | jq -r '.SecretString | fromjson | .["MY_SECRET"]')

    sudo sed -i '' "s/BITRISE_AGENT_TOKEN/$TOKEN/" /Users/ec2-user/Library/LaunchDaemons/io.bitrise.self-hosted-agent.plist
    sudo launchctl load -w /Users/ec2-user/Library/LaunchDaemons/io.bitrise.self-hosted-agent.plist
  3. User dataセクションで、シェルスクリプトやその他のカスタムデータを設定することもできます。

    EC2 MacおよびLinuxインスタンスの詳細設定セクションでは、user dataでインスタンスを最適化するための推奨事項を確認できます: