mirror of
https://github.com/actions/runner.git
synced 2025-12-10 12:36:23 +00:00
54 lines
1.7 KiB
Markdown
54 lines
1.7 KiB
Markdown
# Git Connection Check
|
|
|
|
## What is this check for?
|
|
|
|
Make sure `git` can access GitHub.com or your GitHub Enterprise Server.
|
|
|
|
|
|
## What is checked?
|
|
|
|
The test is done by executing
|
|
```bash
|
|
# For GitHub.com
|
|
git ls-remote --exit-code https://github.com/actions/checkout HEAD
|
|
|
|
# For GitHub Enterprise Server
|
|
git ls-remote --exit-code https://ghes.me/actions/checkout HEAD
|
|
```
|
|
|
|
The test also set environment variable `GIT_TRACE=1` and `GIT_CURL_VERBOSE=1` before running `git ls-remote`, this will make `git` to produce debug log for better debug any potential issues.
|
|
|
|
## How to fix the issue?
|
|
|
|
### 1. Check global and system git config
|
|
|
|
If you are having issues connecting to the server, check your global and system git config for any unexpected authentication headers. You might be seeing an error like:
|
|
|
|
```
|
|
fatal: unable to access 'https://github.com/actions/checkout/': The requested URL returned error: 400
|
|
```
|
|
|
|
The following commands can be used to check for unexpected authentication headers:
|
|
|
|
```
|
|
$ git config --global --list | grep extraheader
|
|
http.extraheader=AUTHORIZATION: unexpected_auth_header
|
|
|
|
$ git config --system --list | grep extraheader
|
|
```
|
|
|
|
The following command can be used to remove the above value: `git config --global --unset http.extraheader`
|
|
|
|
### 2. Check the common network issue
|
|
|
|
> Please check the [network doc](./network.md)
|
|
|
|
### 3. SSL certificate related issue
|
|
|
|
If you are seeing `SSL Certificate problem:` in the log, it means the `git` can't connect to the GitHub server due to SSL handshake failure.
|
|
> Please check the [SSL cert doc](./sslcert.md)
|
|
|
|
## Still not working?
|
|
|
|
Contact GitHub customer service or log an issue at https://github.com/actions/runner if you think it's a runner issue.
|