Difference between revisions of "GitHub Actions: uses: actions/checkout"

From wikieduonline
Jump to navigation Jump to search
 
(26 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
{{lowercase}}
+
<code>[[actions/checkout@v4]]</code> [https://github.com/actions/checkout ref]
−
* https://github.com/actions/checkout
+
* <code>[[uses:]] [[actions/checkout@v3]]</code>
 +
** <code>[[actions/[email protected]]]</code>
 +
* <code>uses: [[actions/]][[checkout]]@v2<ref>https://github.com/actions/checkout</ref></code>
  
 +
== Full options ==
 +
- uses: [[actions/]]checkout@v3
 +
  with:
 +
    [[repository:]] ''
 +
    ref: ''
 +
    token: ''
 +
    ssh-key: ''
 +
    ssh-known-hosts: ''
 +
    ssh-strict: ''
 +
    persist-credentials: ''
 +
    path: ''
 +
    clean: ''
 +
    fetch-depth: ''
 +
    lfs: ''
 +
    [[submodules:]] ''
 +
    set-safe-directory: ''
  
−
* <code>[[actions]]/checkout@v3</code>
+
== Examples ==
 +
- uses: actions/checkout@v3
 +
  with:
 +
    [[repository:]] your_repo
 +
 
 +
- uses: actions/checkout@v3
 +
  with:
 +
    [[repository:]] your_repo@[[branch]]
 +
 
 +
- uses: actions/checkout@v3
 +
  with:
 +
    ref: my-branch
 +
 
 +
{{run ex}}
 +
 
 +
== Original documentation with comments ==
 +
<pre>
 +
- uses: actions/checkout@v3
 +
  with:
 +
    # Repository name with owner. For example, actions/checkout
 +
    # Default: ${{ github.repository }}
 +
    repository: ''
 +
 
 +
    # The branch, tag or SHA to checkout. When checking out the repository that
 +
    # triggered a workflow, this defaults to the reference or SHA for that event.
 +
    # Otherwise, uses the default branch.
 +
    ref: ''
 +
 
 +
    # Personal access token (PAT) used to fetch the repository. The PAT is configured
 +
    # with the local git config, which enables your scripts to run authenticated git
 +
    # commands. The post-job step removes the PAT.
 +
    #
 +
    # We recommend using a service account with the least permissions necessary. Also
 +
    # when generating a new PAT, select the least scopes necessary.
 +
    #
 +
    # [Learn more about creating and using encrypted secrets](https://help.github.com/en/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)
 +
    #
 +
    # Default: ${{ github.token }}
 +
    token: ''
 +
 
 +
    # SSH key used to fetch the repository. The SSH key is configured with the local
 +
    # git config, which enables your scripts to run authenticated git commands. The
 +
    # post-job step removes the SSH key.
 +
    #
 +
    # We recommend using a service account with the least permissions necessary.
 +
    #
 +
    # [Learn more about creating and using encrypted secrets](https://help.github.com/en/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)
 +
    ssh-key: ''
 +
 
 +
    # Known hosts in addition to the user and global host key database. The public SSH
 +
    # keys for a host may be obtained using the utility `ssh-keyscan`. For example,
 +
    # `ssh-keyscan github.com`. The public key for github.com is always implicitly
 +
    # added.
 +
    ssh-known-hosts: ''
 +
 
 +
    # Whether to perform strict host key checking. When true, adds the options
 +
    # `StrictHostKeyChecking=yes` and `CheckHostIP=no` to the SSH command line. Use
 +
    # the input `ssh-known-hosts` to configure additional hosts.
 +
    # Default: true
 +
    ssh-strict: ''
 +
 
 +
    # Whether to configure the token or SSH key with the local git config
 +
    # Default: true
 +
    persist-credentials: ''
 +
 
 +
    # Relative path under $GITHUB_WORKSPACE to place the repository
 +
    path: ''
 +
 
 +
    # Whether to execute `git clean -ffdx && git reset --hard HEAD` before fetching
 +
    # Default: true
 +
    clean: ''
 +
 
 +
    # Number of commits to fetch. 0 indicates all history for all branches and tags.
 +
    # Default: 1
 +
    fetch-depth: ''
 +
 
 +
    # Whether to download Git-LFS files
 +
    # Default: false
 +
    lfs: ''
 +
 
 +
    # Whether to checkout submodules: `true` to checkout submodules or `recursive` to
 +
    # recursively checkout submodules.
 +
    #
 +
    # When the `ssh-key` input is not provided, SSH URLs beginning with
 +
    # `[email protected]:` are converted to HTTPS.
 +
    #
 +
    # Default: false
 +
    submodules: ''
 +
 
 +
    # Add repository path as safe.directory for Git global config by running `git
 +
    # config --global --add safe.directory <path>`
 +
    # Default: true
 +
    set-safe-directory: ''
 +
</pre>
  
 
== Related ==
 
== Related ==
−
* [[GitHub Actions: uses:]]
+
* [[GitHub Actions]] <code>[[GitHub Actions: uses:|uses:]]</code>
 +
* <code>[[git checkout]]</code>
 +
* <code>[[actions/[email protected]]]</code>
 +
* <code>[[cycjimmy/semantic-release-action@v3]]</code>
  
 
== See also ==
 
== See also ==
 +
* {{aws-actions}}
 +
* {{uses}}
 
* {{GitHub Actions}}
 
* {{GitHub Actions}}
  
 
[[Category:GitHub]]
 
[[Category:GitHub]]

Latest revision as of 10:07, 21 October 2024

actions/checkout@v4 ref

Full options[edit]

- uses: actions/checkout@v3
  with:
    repository: 
    ref: 
    token: 
    ssh-key: 
    ssh-known-hosts: 
    ssh-strict: 
    persist-credentials: 
    path: 
    clean: 
    fetch-depth: 
    lfs: 
    submodules: 
    set-safe-directory:

Examples[edit]

- uses: actions/checkout@v3
  with:
    repository: your_repo

- uses: actions/checkout@v3
  with:
    repository: your_repo@branch

- uses: actions/checkout@v3
  with:
    ref: my-branch



jobs:
  my_build:
    runs-on: ubuntu-latest
    steps:
      - name: Checking out our code
        uses: actions/checkout@master
      - name: Say something
        run: |
          echo "A little less ${message}"
          echo "A little more action"

Original documentation with comments[edit]

- uses: actions/checkout@v3
  with:
    # Repository name with owner. For example, actions/checkout
    # Default: ${{ github.repository }}
    repository: ''

    # The branch, tag or SHA to checkout. When checking out the repository that
    # triggered a workflow, this defaults to the reference or SHA for that event.
    # Otherwise, uses the default branch.
    ref: ''

    # Personal access token (PAT) used to fetch the repository. The PAT is configured
    # with the local git config, which enables your scripts to run authenticated git
    # commands. The post-job step removes the PAT.
    #
    # We recommend using a service account with the least permissions necessary. Also
    # when generating a new PAT, select the least scopes necessary.
    #
    # [Learn more about creating and using encrypted secrets](https://help.github.com/en/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)
    #
    # Default: ${{ github.token }}
    token: ''

    # SSH key used to fetch the repository. The SSH key is configured with the local
    # git config, which enables your scripts to run authenticated git commands. The
    # post-job step removes the SSH key.
    #
    # We recommend using a service account with the least permissions necessary.
    #
    # [Learn more about creating and using encrypted secrets](https://help.github.com/en/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)
    ssh-key: ''

    # Known hosts in addition to the user and global host key database. The public SSH
    # keys for a host may be obtained using the utility `ssh-keyscan`. For example,
    # `ssh-keyscan github.com`. The public key for github.com is always implicitly
    # added.
    ssh-known-hosts: ''

    # Whether to perform strict host key checking. When true, adds the options
    # `StrictHostKeyChecking=yes` and `CheckHostIP=no` to the SSH command line. Use
    # the input `ssh-known-hosts` to configure additional hosts.
    # Default: true
    ssh-strict: ''

    # Whether to configure the token or SSH key with the local git config
    # Default: true
    persist-credentials: ''

    # Relative path under $GITHUB_WORKSPACE to place the repository
    path: ''

    # Whether to execute `git clean -ffdx && git reset --hard HEAD` before fetching
    # Default: true
    clean: ''

    # Number of commits to fetch. 0 indicates all history for all branches and tags.
    # Default: 1
    fetch-depth: ''

    # Whether to download Git-LFS files
    # Default: false
    lfs: ''

    # Whether to checkout submodules: `true` to checkout submodules or `recursive` to
    # recursively checkout submodules.
    #
    # When the `ssh-key` input is not provided, SSH URLs beginning with
    # `[email protected]:` are converted to HTTPS.
    #
    # Default: false
    submodules: ''

    # Add repository path as safe.directory for Git global config by running `git
    # config --global --add safe.directory <path>`
    # Default: true
    set-safe-directory: ''

Related[edit]

See also[edit]

  • ↑ https://github.com/actions/checkout
    • Retrieved from "https://www.wikieduonline.com/index.php?title=GitHub_Actions:_uses:_actions/checkout&oldid=351052"

    Advertising: