Package io.github.cdklabs.projen.github.workflows

Interface Triggers

    • Method Detail

      • getBranchProtectionRule

        @Stability(Experimental)
@Nullable
default BranchProtectionRuleOptions getBranchProtectionRule()
        (experimental) Runs your workflow anytime the branch_protection_rule event occurs.

      • getCheckRun

        @Stability(Experimental)
@Nullable
default CheckRunOptions getCheckRun()
        (experimental) Runs your workflow anytime the check_run event occurs.

      • getCheckSuite

        @Stability(Experimental)
@Nullable
default CheckSuiteOptions getCheckSuite()
        (experimental) Runs your workflow anytime the check_suite event occurs.

      • getCreate

        @Stability(Experimental)
@Nullable
default CreateOptions getCreate()
        (experimental) Runs your workflow anytime someone creates a branch or tag, which triggers the create event.

      • getDelete

        @Stability(Experimental)
@Nullable
default DeleteOptions getDelete()
        (experimental) Runs your workflow anytime someone deletes a branch or tag, which triggers the delete event.

      • getDeployment

        @Stability(Experimental)
@Nullable
default DeploymentOptions getDeployment()
        (experimental) Runs your workflow anytime someone creates a deployment, which triggers the deployment event.

        Deployments created with a commit SHA may not have a Git ref.

      • getDeploymentStatus

        @Stability(Experimental)
@Nullable
default DeploymentStatusOptions getDeploymentStatus()
        (experimental) Runs your workflow anytime a third party provides a deployment status, which triggers the deployment_status event.

        Deployments created with a commit SHA may not have a Git ref.

      • getFork

        @Stability(Experimental)
@Nullable
default ForkOptions getFork()
        (experimental) Runs your workflow anytime when someone forks a repository, which triggers the fork event.

      • getGollum

        @Stability(Experimental)
@Nullable
default GollumOptions getGollum()
        (experimental) Runs your workflow when someone creates or updates a Wiki page, which triggers the gollum event.

      • getIssueComment

        @Stability(Experimental)
@Nullable
default IssueCommentOptions getIssueComment()
        (experimental) Runs your workflow anytime the issue_comment event occurs.

      • getIssues

        @Stability(Experimental)
@Nullable
default IssuesOptions getIssues()
        (experimental) Runs your workflow anytime the issues event occurs.

      • getLabel

        @Stability(Experimental)
@Nullable
default LabelOptions getLabel()
        (experimental) Runs your workflow anytime the label event occurs.

      • getMergeGroup

        @Stability(Experimental)
@Nullable
default MergeGroupOptions getMergeGroup()
        (experimental) Runs your workflow when a pull request is added to a merge queue, which adds the pull request to a merge group.

      • getMilestone

        @Stability(Experimental)
@Nullable
default MilestoneOptions getMilestone()
        (experimental) Runs your workflow anytime the milestone event occurs.

      • getPageBuild

        @Stability(Experimental)
@Nullable
default PageBuildOptions getPageBuild()
        (experimental) Runs your workflow anytime someone pushes to a GitHub Pages-enabled branch, which triggers the page_build event.

      • getProject

        @Stability(Experimental)
@Nullable
default ProjectOptions getProject()
        (experimental) Runs your workflow anytime the project event occurs.

      • getProjectCard

        @Stability(Experimental)
@Nullable
default ProjectCardOptions getProjectCard()
        (experimental) Runs your workflow anytime the project_card event occurs.

      • getProjectColumn

        @Stability(Experimental)
@Nullable
default ProjectColumnOptions getProjectColumn()
        (experimental) Runs your workflow anytime the project_column event occurs.

      • getPublicValue

        @Stability(Experimental)
@Nullable
default PublicOptions getPublicValue()
        (experimental) Runs your workflow anytime someone makes a private repository public, which triggers the public event.

      • getPullRequest

        @Stability(Experimental)
@Nullable
default PullRequestOptions getPullRequest()
        (experimental) Runs your workflow anytime the pull_request event occurs.

      • getPullRequestReview

        @Stability(Experimental)
@Nullable
default PullRequestReviewOptions getPullRequestReview()
        (experimental) Runs your workflow anytime the pull_request_review event occurs.

      • getPullRequestReviewComment

        @Stability(Experimental)
@Nullable
default PullRequestReviewCommentOptions getPullRequestReviewComment()
        (experimental) Runs your workflow anytime a comment on a pull request's unified diff is modified, which triggers the pull_request_review_comment event.

      • getPullRequestTarget

        @Stability(Experimental)
@Nullable
default PullRequestTargetOptions getPullRequestTarget()
        (experimental) This event runs in the context of the base of the pull request, rather than in the merge commit as the pull_request event does.

        This prevents executing unsafe workflow code from the head of the pull request that could alter your repository or steal any secrets you use in your workflow. This event allows you to do things like create workflows that label and comment on pull requests based on the contents of the event payload.

        WARNING: The pull_request_target event is granted read/write repository token and can access secrets, even when it is triggered from a fork. Although the workflow runs in the context of the base of the pull request, you should make sure that you do not check out, build, or run untrusted code from the pull request with this event. Additionally, any caches share the same scope as the base branch, and to help prevent cache poisoning, you should not save the cache if there is a possibility that the cache contents were altered.

        See Also:
        https://securitylab.github.com/research/github-actions-preventing-pwn-requests

      • getPush

        @Stability(Experimental)
@Nullable
default PushOptions getPush()
        (experimental) Runs your workflow when someone pushes to a repository branch, which triggers the push event.

      • getRegistryPackage

        @Stability(Experimental)
@Nullable
default RegistryPackageOptions getRegistryPackage()
        (experimental) Runs your workflow anytime a package is published or updated.

      • getRelease

        @Stability(Experimental)
@Nullable
default ReleaseOptions getRelease()
        (experimental) Runs your workflow anytime the release event occurs.

      • getRepositoryDispatch

        @Stability(Experimental)
@Nullable
default RepositoryDispatchOptions getRepositoryDispatch()
        (experimental) You can use the GitHub API to trigger a webhook event called repository_dispatch when you want to trigger a workflow for activity that happens outside of GitHub.

      • getStatus

        @Stability(Experimental)
@Nullable
default StatusOptions getStatus()
        (experimental) Runs your workflow anytime the status of a Git commit changes, which triggers the status event.

      • getWatch

        @Stability(Experimental)
@Nullable
default WatchOptions getWatch()
        (experimental) Runs your workflow anytime the watch event occurs.

      • getWorkflowDispatch

        @Stability(Experimental)
@Nullable
default WorkflowDispatchOptions getWorkflowDispatch()
        (experimental) You can configure custom-defined input properties, default input values, and required inputs for the event directly in your workflow.

        When the workflow runs, you can access the input values in the github.event.inputs context.

      • getWorkflowRun

        @Stability(Experimental)
@Nullable
default WorkflowRunOptions getWorkflowRun()
        (experimental) This event occurs when a workflow run is requested or completed, and allows you to execute a workflow based on the finished result of another workflow.

        A workflow run is triggered regardless of the result of the previous workflow.