Integrazione GitHub delle azioni in un flusso di lavoro

Un'GitHub azione è molto simile a un'CodeCatalyst azione, tranne per il fatto che è stata sviluppata per essere utilizzata con i flussi GitHub di lavoro. Per informazioni dettagliate sulle GitHub azioni, consulta la documentazione relativa GitHub alle azioni.

È possibile utilizzare GitHub le azioni insieme alle CodeCatalyst azioni native in un CodeCatalyst flusso di lavoro.

Esistono due modi per aggiungere un' GitHub azione a un CodeCatalyst flusso di lavoro:

• Puoi selezionare l' GitHub azione da un elenco curato nella CodeCatalyst console. Sono disponibili diverse GitHub azioni popolari. Per ulteriori informazioni, consulta Aggiungere un'azione curata GitHub .

• Se l' GitHub azione che desideri utilizzare non è disponibile nella CodeCatalyst console, puoi aggiungerla utilizzando un'azione GitHub Azioni.

  Un'azione GitHub Actions è un'CodeCatalyst azione che racchiude un' GitHub azione e la rende compatibile con CodeCatalyst i flussi di lavoro.

  Ecco un esempio di azione GitHub Actions che completa l'azione Super-Linter: 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

  Nel codice precedente, l'azione CodeCatalyst GitHub Actions (identificata daaws/github-actions-runner@v1) racchiude l'azione Super-Linter (identificata da), github/super-linter@v4 facendola funzionare in un flusso di lavoro. CodeCatalyst

  Per ulteriori informazioni, consulta Aggiungere l'azione "GitHub Azioni».

Tutte le GitHub azioni, curate e non, devono essere racchiuse all'interno di un'GitHub azione Actions (), come mostrato nell'esempio precedente. aws/github-actions-runner@v1 Il wrapper è necessario per il corretto funzionamento dell'azione.

In che modo le GitHub azioni sono diverse dalle CodeCatalyst azioni?

GitHub Le azioni utilizzate all'interno di un CodeCatalyst flusso di lavoro non hanno lo stesso livello di accesso e integrazione AWS e CodeCatalyst le stesse funzionalità (come ambienti e problemi) CodeCatalyst delle azioni.

GitHub Le azioni possono interagire con altre CodeCatalyst azioni nel flusso di lavoro?

Sì. Ad esempio, GitHub le azioni possono utilizzare variabili prodotte da altre CodeCatalyst azioni come input e possono anche condividere parametri e artefatti di output con CodeCatalyst le azioni. Per ulteriori informazioni, consulta Esportazione di un parametro GitHub di output in modo che altre azioni possano utilizzarlo e Riferimento a un parametro di GitHub output.

Quali GitHub azioni posso usare?

Puoi utilizzare qualsiasi GitHub azione disponibile tramite la CodeCatalyst console e qualsiasi GitHub azione disponibile nel GitHubMarketplace. Se decidi di utilizzare un' GitHub azione dal Marketplace, tieni presente le seguenti limitazioni.

Limitazioni delle GitHub azioni in CodeCatalyst

• GitHub Le azioni non possono essere utilizzate con il tipo di calcolo CodeCatalyst Lambda.

• GitHub Le azioni vengono eseguite sull'immagine Docker dell'ambiente di runtime di novembre 2022, che include strumenti precedenti. Per ulteriori informazioni sull'immagine e sugli strumenti, consulta. Specificazione delle immagini Docker dell'ambiente di runtime

• GitHub Le azioni che si basano internamente sul githubcontesto o che fanno riferimento GitHub a risorse specifiche non funzioneranno. CodeCatalyst Ad esempio, le seguenti azioni non funzioneranno in: CodeCatalyst

  • Azioni che tentano di aggiungere, modificare o aggiornare GitHub risorse. Gli esempi includono azioni che aggiornano le richieste pull o creano problemi in GitHub.

  • Quasi tutte le azioni elencate in https://github.com/actions.

• GitHub Le azioni che sono azioni del contenitore Docker funzioneranno, ma devono essere eseguite dall'utente Docker predefinito (root). Non eseguire l'azione come utente 1001. (Al momento della scrittura, l'utente 1001 lavora in GitHub, ma non in CodeCatalyst.) Per ulteriori informazioni, consulta l'argomento USER nel supporto di Dockerfile per Actions. GitHub

Per un elenco delle GitHub azioni disponibili tramite la CodeCatalyst console, consulta. Aggiungere un'azione curata GitHub

Come faccio ad aggiungere un' GitHub azione (passaggi di alto livello)?

I passaggi di alto livello per aggiungere un' GitHub azione a un CodeCatalyst flusso di lavoro sono i seguenti:

1. Nel tuo CodeCatalyst progetto, crei un flusso di lavoro. Il flusso di lavoro è il luogo in cui definisci come creare, testare e distribuire l'applicazione. Per ulteriori informazioni, consulta Guida introduttiva ai flussi di lavoro.

2. Nel flusso di lavoro, aggiungi un'azione curata o aggiungi l' GitHub azione GitHub Azioni.

3. Effettuate una delle seguenti operazioni:

   • Se hai scelto di aggiungere un'azione curata, configurala. Per ulteriori informazioni, consulta Aggiungere un'azione curata GitHub .

   • Se scegli di aggiungere un'azione non curata, all'interno dell'azione GitHubAzioni, incolli il codice YAML dell' GitHub azione. Puoi trovare questo codice nella pagina dei dettagli dell' GitHubazione scelta nel GitHubMarketplace. Probabilmente dovrai modificare leggermente il codice per farlo funzionare CodeCatalyst. Per ulteriori informazioni, consulta Aggiungere l'azione "GitHub Azioni».

4. (Facoltativo) All'interno del flusso di lavoro, aggiungi altre azioni come le azioni di compilazione e test. Per ulteriori informazioni, consulta Crea, testa e distribuisci con flussi di lavoro in CodeCatalyst.

5. Il flusso di lavoro viene avviato manualmente o automaticamente tramite un trigger. Il flusso di lavoro esegue l' GitHub azione e qualsiasi altra azione del flusso di lavoro. Per ulteriori informazioni, consulta Avvio di un flusso di lavoro eseguito manualmente.

Per i passaggi dettagliati, consulta:

• Aggiungere un'azione curata GitHub .

• Aggiungere l'azione "GitHub Azioni».

L' GitHub azione viene eseguita GitHub?

No. L' GitHub azione viene eseguita CodeCatalyst, utilizzando le macchine CodeCatalyst di compilazione.

Posso usare anche i GitHub flussi di lavoro?

No.

Argomenti

• Tutorial: codice Lint utilizzando un' GitHubazione in un flusso di lavoro
• Aggiungere l'azione "GitHub Azioni»
• Aggiungere un'azione curata GitHub
• Esportazione di un parametro GitHub di output in modo che altre azioni possano utilizzarlo
• Riferimento a un parametro di GitHub output
• Definizione YAML dell'GitHub azione «Azioni»