ワークフローへの GitHub アクションの統合 - Amazon CodeCatalyst

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ワークフローへの GitHub アクションの統合

GitHub アクションは、 GitHub ワークフローでの使用のために開発されたことを除いて、CodeCatalyst アクション とよく似ています。 GitHub アクションの詳細については、GitHub アクションのドキュメントを参照してください。

CodeCatalyst ワークフローのネイティブ GitHub アクションと一緒に CodeCatalyst アクションを使用できます。

GitHub アクションを CodeCatalyst ワークフローに追加するには、次の 2 つの方法があります。

  • CodeCatalyst コンソールのキュレートされたリストから GitHub アクションを選択できます。いくつかの一般的な GitHub アクションが利用可能です。詳細については、「 GitHub キュレーションされたアクションの追加」を参照してください。

  • 使用する GitHub アクションが CodeCatalyst コンソールで利用できない場合は、GitHub アクションアクションを使用して追加できます。

    GitHub Actions アクションは、CodeCatalyst アクションをラップし、 CodeCatalyst ワークフローと互換性を持たせる GitHub アクションです。

    スーパーリンター GitHubアクションをラップするGitHub アクションアクションの例を次に示します。

    Actions: GitHubAction: Identifier: aws/github-actions-runner@v1 Configuration: Steps: - name: Lint Code Base uses: github/super-linter@v4 env: VALIDATE_ALL_CODEBASE: "true" DEFAULT_BRANCH: main

    前のコードでは、 CodeCatalyst GitHub アクションアクション ( で識別aws/github-actions-runner@v1) は Super-Linter アクション ( で識別github/super-linter@v4) をラップし、 CodeCatalyst ワークフローで機能します。

    詳細については、「「GitHub アクション」アクションの追加」を参照してください。

前の例に示すように、キュレーションされた GitHub アクションとキュレートされていないアクションの両方をGitHub アクションアクション (aws/github-actions-runner@v1) 内にラップする必要があります。アクションが正しく機能するには、ラッパーが必要です。

GitHub アクションと CodeCatalyst アクションの違い

GitHub CodeCatalyst ワークフロー内で使用されるアクションには、アクションと同じレベルのアクセス AWS と および CodeCatalyst 機能 (環境問題など) との統合はありません CodeCatalyst 。

GitHub アクションはワークフロー内の他の CodeCatalyst アクションとやり取りできますか?

はい。例えば、 GitHub Actions は、他の CodeCatalyst アクションによって生成された変数を入力として使用したり、出力パラメータやアーティファクトを CodeCatalyst アクションと共有したりできます。詳細については、「他のアクションで使用できるように GitHub 出力パラメータをエクスポートする」および「 GitHub 出力パラメータの参照」を参照してください。

どの GitHub アクションを使用できますか?

CodeCatalyst コンソールから利用可能な任意の GitHub アクション、および GitHub Marketplace で利用可能な任意の GitHub アクションを使用できます。Marketplace の GitHub アクションを使用する場合は、次の制限に注意してください。

での GitHub アクションの制限 CodeCatalyst

  • GitHub githubコンテキストに内部的に依存するアクション、または GitHub固有のリソースを参照するアクションは、 では機能しません CodeCatalyst。例えば、次のアクションは では機能しません CodeCatalyst。

    • GitHub リソースの追加、変更、または更新を試みるアクション。例としては、プルリクエストを更新したり、 で問題を作成したりするアクションなどがあります GitHub。

    • にリストされているほぼすべてのアクションhttps://github.com/actions

  • GitHub Docker コンテナアクションであるアクションは機能しますが、デフォルトの Docker ユーザー (ルート) によって実行する必要があります。ユーザー 1001 としてアクションを実行しないでください。(書き込み時には、ユーザー 1001 は で動作しますが GitHub、 では動作しません) CodeCatalyst。詳細については、「アクション の Dockerfile サポート」の「USER」トピックを参照してください。 GitHub

CodeCatalyst コンソールから利用できる GitHub アクションのリストについては、「」を参照してください GitHub キュレーションされたアクションの追加

GitHub アクション (高レベルステップ) を追加する方法

CodeCatalyst ワークフローに GitHub アクションを追加する大まかな手順は次のとおりです。

  1. CodeCatalyst プロジェクトでは、ワークフロー を作成します。ワークフローでは、アプリケーションを構築、テスト、デプロイする方法を定義します。詳細については、「ワークフローの開始方法」を参照してください。

  2. ワークフローで、キュレートされた GitHub アクションを追加する、 GitHub アクションアクションを追加します

  3. 次のいずれかを実行します。

    • キュレートされたアクションを追加することを選択した場合は、設定します。詳細については、「 GitHub キュレーションされたアクションの追加」を参照してください。

    • 非キュレーションアクションを追加することを選択した場合、GitHubアクションアクション内にアクション GitHub の YAML コード を貼り付けます。このコードは、 GitHub Marketplace の選択した GitHubアクションの詳細ページにあります。コードが で機能するように、コードを少し変更する必要がある場合があります CodeCatalyst。詳細については、「「GitHub アクション」アクションの追加」を参照してください。

  4. (オプション) ワークフロー内で、ビルドアクションやテストアクションなどの他のアクションを追加します。詳細については、「でワークフローを使用して構築、テスト、デプロイする CodeCatalyst」を参照してください。

  5. ワークフローは、手動またはトリガーを使用して自動的に開始します。ワークフローは、 GitHub アクションとワークフロー内の他のアクションを実行します。詳細については、「ワークフローの手動実行の開始」を参照してください。

詳細な手順については、以下を参照してください。

GitHub アクションは で実行されます GitHubか?

いいえ。 GitHub アクションは CodeCatalyst、 CodeCatalystのビルドマシン を使用して で実行されます。

GitHub ワークフローを使用することもできますか?

いいえ。