Skip to content

03-piped.md

Latest commit

 

History

History
100 lines (67 loc) · 4.43 KB

03-piped.md

File metadata and controls

100 lines (67 loc) · 4.43 KB

3. Pipedの構築

このページでは、シングルバイナリのPipedエージェントをローカルで実行していきます。

インストール

  1. PipedのIDをコンソールで払い出します。

    1-1. Piped設定画面にアクセスします。http://localhost:8080/settings/piped

    1-2. + ADDをクリックします。 ADD Piped

    1-3. 任意のNameとDescriptionを入力し、SAVEをクリックします。 Input piped

    1-4. PipedのIDとKeyが表示されます。 これらは以降のステップで使用します。 Piped is registered

  2. 1. Gitリポジトリのセットアップでcloneしたディレクトリに移動します。

    cd <YOUR_CLONED_TUTORIAL_DIR>
cd src/install/piped/

  3. 下記の<YOUR_PIPED_KEY>を1-4.で取得したPiped Keyの値に置き換え、そのKeyのファイルを作成します。1

    echo -n <YOUR_PIPED_KEY> > .pipedKey

  4. ローカルのsrc/install/piped/piped.yamlを以下のように編集します。

    • spec.pipedID: 1-4.で取得したPiped Id
    • spec.pipedKeyFile: <YOUR_CLONED_TUTORIAL_DIR>/src/install/piped/.pipedKey
    • spec.repositories[0].remote: 1. Gitリポジトリのセットアップで作成したGitHub上のプライベートリポジトリのURL
    • spec.platformProviders: デプロイ先となる環境の項目をコメントアウト解除します。

  5. pipecd/releasesからPipedの公式バイナリを取得します。OSとCPUは適宜選択してください。

    # OS=darwin or linux
# CPU=arm64 or amd64
curl -Lo ./piped  https://github.com/pipe-cd/pipecd/releases/download/v0.50.1/piped_v0.50.1_${OS}_${CPU}

  6. Pipedの実行権限を付与します。

    chmod +x ./piped

  7. Pipedを実行します。2

    ./piped piped --config-file=./piped.yaml --insecure
    トラブルシューティング (クリックして拡げる)

    • failed to create api client {"error": "context deadline exceeded"}

      • PipedがControl Planeへの接続に失敗したことを意味します。
      • piped.yaml内のapiAddressが正しいか確認してください。
      • Control PlaneがapiAddressで指定したポートで稼働しているか確認してください。

    • rpc error: code = Unauthenticated desc = Unauthenticated

      • PipedがControl Planeへの接続に成功したものの、認証に失敗したことを意味します。
      • piped.yaml内のprojectID, pipedID, pipedKeyFileが正しいか確認してください。
      • pipedKeyFileで指定したファイル内の値が正しいか確認してください。

    • failed to clone from remote

      • PipedがControl Planeへの接続・認証に成功したものの、GitHubからのcloneに失敗したことを意味します。
      • piped.yaml内のspec.git.repositories> remote, branchが正しいか確認してください。

確認

  1. Piped設定画面にアクセスします。 http://localhost:8080/settings/piped

    Pipedの起動に成功していた場合、緑(Online)のマークがName欄に表示されます。 緑になっていない場合、1,2分ほど待機してください。 Piped Status

関連情報

次: デプロイ >

< 戻る: 2. Control Planeの構築

Footnotes

  1. PipedのKeyはクレデンシャルのため、公開しないでください。実運用では、Keyと piped.yamlはシークレット管理ツールで管理することが推奨されます。 ↩

  2. --insecureオプションによって、PipedからControl Planeへの通信のTLSを無効化しています。 (cf. Piped's Runtime Options) ↩