Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/learn/how-to-guides/ci-pipelines/run-argos-in-ci.md
Original file line number Diff line number Diff line change
Expand Up @@ -147,7 +147,7 @@ On a CI provider that isn't in the table above, such as Jenkins, Azure Pipelines

Options passed to the SDK or the CLI take precedence over these variables, and both take precedence over the values detected from your CI provider. These variables also override detection on the providers listed above.

To find the baseline, Argos walks the commit history. When your project is connected to GitHub or GitLab, this happens server-side. Otherwise Argos reads it from the `origin` remote, or from the local history, so make sure your checkout has enough history, or pin the baseline with `ARGOS_REFERENCE_COMMIT`. See the [CLI reference](../../../sdks-reference/argos-command-line-interface-cli.md#override-git-detection).
To find the baseline, Argos walks the commit history. When your project is connected to GitLab, or to GitHub with [full access](../../integrations/github-integration.md#choose-your-access-level), this happens server-side. Otherwise Argos reads it from the `origin` remote, or from the local history, so make sure your checkout has enough history, or pin the baseline with `ARGOS_REFERENCE_COMMIT`. See the [CLI reference](../../../sdks-reference/argos-command-line-interface-cli.md#override-git-detection).

### Troubleshooting

Expand Down
12 changes: 10 additions & 2 deletions docs/learn/integrations/github-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -81,8 +81,8 @@ A required status check blocks merging while it is pending, just as it does whil

### Choose your access level

* **Full access (recommended)** — Required for Merge Queue and baseline selection based on commit history.
* **Limited access (no content)** — Works for basic checks without reading repository content; Merge Queue is not supported. See [GitHub integration without content permission](github-integration.md#github-integration-without-content-permission).
* **Full access (recommended)**: Argos reads the commit history from GitHub to find the [baseline build](../platform-fundamentals/baseline-build.md), whatever history your CI checkout has. Required for Merge Queue.
* **Limited access (no content)**: Argos never reads your repository content. The Argos SDK finds the baseline from the commit history of your CI checkout instead. Merge Queue is not supported. See [GitHub integration without content permission](github-integration.md#github-integration-without-content-permission).

Use GitHub Connect to log in with your GitHub account, then install the Argos GitHub App to link repositories.

Expand Down Expand Up @@ -200,6 +200,14 @@ If you prefer to use Argos without granting full content access to your reposito

9. Choose the repository you want to connect.

#### How Argos finds the baseline without content access

Argos can't read your commit history from GitHub, so the Argos SDK reads it in your CI job instead, from the repository the job runs in. It finds the merge base of your branch and its [baseline branch](../platform-fundamentals/baseline-build.md#the-baseline-branch), then sends Argos the commit SHAs of the merge base and its ancestors, never the content of your files. Argos picks the [baseline build](../platform-fundamentals/baseline-build.md#how-argos-selects-the-baseline) among these commits.

On a GitHub Actions `pull_request` event, GitHub tests your branch merged into the tip of the base branch. The SDK then starts from that tip instead of the merge base, so changes already merged into the base branch don't show up as changes of your pull request.

The SDK fetches the history it needs from the `origin` remote, so shallow clones work, including the default `actions/checkout` setup. Without `origin`, it falls back to the local history. When it finds no merge base, the build has no baseline and becomes an [orphan](../platform-fundamentals/baseline-build.md#orphan-builds). To pin the baseline yourself, set [`ARGOS_REFERENCE_COMMIT`](../platform-fundamentals/baseline-build.md#choose-a-custom-baseline-via-sdk).

### GitHub Enterprise

#### GitHub Enterprise Cloud
Expand Down
2 changes: 1 addition & 1 deletion docs/sdks-reference/argos-command-line-interface-cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -196,7 +196,7 @@ argos upload ./screenshots --project my-account/my-project

In a non-Git environment, `ARGOS_COMMIT` and `ARGOS_BRANCH` are required — without them the upload fails with "Argos requires a branch and a commit to be set".

To find the [baseline](../learn/platform-fundamentals/baseline-build.md), Argos resolves ancestor commits. When your project is connected to GitHub or GitLab, this happens server-side. Otherwise the CLI fetches history from the `origin` remote — in a repository without `origin` (for example a local mirror), it falls back to the local history, so make sure enough history is available locally, or pin the baseline explicitly with `--reference-commit` and `--reference-branch`. Parent commits are always computed automatically and cannot be set manually.
To find the [baseline](../learn/platform-fundamentals/baseline-build.md), Argos resolves ancestor commits. When your project is connected to GitLab, or to GitHub with [full access](../learn/integrations/github-integration.md#choose-your-access-level), this happens server-side. Otherwise the CLI fetches history from the `origin` remote. In a repository without `origin` (for example a local mirror), it falls back to the local history, so make sure enough history is available locally, or pin the baseline explicitly with `--reference-commit` and `--reference-branch`. Parent commits are always computed automatically and cannot be set manually.

To see what the CLI detected, run it with debug output:

Expand Down