GitHub workflow directory configuration¶

In GitHub Actions, workflows are defined as YAML files stored in a specific, standardized directory path within a repository to enable automation.^[github-action.md]

Directory Path¶

The required directory for storing workflow configuration files is .github/workflows^[github-action.md]. GitHub scans this location to identify and trigger the defined automation processes^[github-action.md] (Related: GitHub Actions).

File Format¶

Each workflow must be defined as an individual file^[github-action.md]. These files use standard YAML syntax to define the automation logic^[github-action.md].

Workflow Structure¶

The execution logic follows a hierarchy: an event triggers a workflow, which contains one or more jobs^[github-action.md].

• Event: The initiator of the process (e.g., a push, pull request, or manual trigger).
• Workflow: The overarching automation process.
• Jobs: Specific tasks or actions executed within the workflow^[github-action.md].

Related Concepts¶

• CI/CD
• GitHub Actions
• [[YAML]]

Sources¶

^[github-action.md]