diff --git a/README.md b/README.md
index 64dc025..f04b76e 100644
--- a/README.md
+++ b/README.md
@@ -103,6 +103,11 @@ Please refer to the [release page](https://github.com/actions/checkout/releases/
# Default: true
show-progress: ''
+ # Path to a local bare git [reference repository to minimize network
+ # usage](https://git-scm.com/docs/git-clone#Documentation/git-clone.txt---reference-if-ableltrepositorygt).
+ # If the directory doesn't exists this option will ignore it and log a message.
+ reference: ''
+
# Whether to download Git-LFS files
# Default: false
lfs: ''
diff --git a/__test__/git-auth-helper.test.ts b/__test__/git-auth-helper.test.ts
index 7633704..574b4e8 100644
--- a/__test__/git-auth-helper.test.ts
+++ b/__test__/git-auth-helper.test.ts
@@ -763,6 +763,7 @@ async function setup(testName: string): Promise<void> {
lfsInstall: jest.fn(),
log1: jest.fn(),
remoteAdd: jest.fn(),
+ referenceAdd: jest.fn(),
removeEnvironmentVariable: jest.fn((name: string) => delete git.env[name]),
revParse: jest.fn(),
setEnvironmentVariable: jest.fn((name: string, value: string) => {
@@ -824,7 +825,8 @@ async function setup(testName: string): Promise<void> {
sshUser: '',
workflowOrganizationId: 123456,
setSafeDirectory: true,
- githubServerUrl: githubServerUrl
+ githubServerUrl: githubServerUrl,
+ reference: '/some/path'
}
}
diff --git a/__test__/git-directory-helper.test.ts b/__test__/git-directory-helper.test.ts
index 22e9ae6..e430cb7 100644
--- a/__test__/git-directory-helper.test.ts
+++ b/__test__/git-directory-helper.test.ts
@@ -478,6 +478,7 @@ async function setup(testName: string): Promise<void> {
lfsInstall: jest.fn(),
log1: jest.fn(),
remoteAdd: jest.fn(),
+ referenceAdd: jest.fn(),
removeEnvironmentVariable: jest.fn(),
revParse: jest.fn(),
setEnvironmentVariable: jest.fn(),
diff --git a/__test__/input-helper.test.ts b/__test__/input-helper.test.ts
index 9514cb4..c14f17d 100644
--- a/__test__/input-helper.test.ts
+++ b/__test__/input-helper.test.ts
@@ -91,6 +91,7 @@ describe('input-helper tests', () => {
expect(settings.repositoryOwner).toBe('some-owner')
expect(settings.repositoryPath).toBe(gitHubWorkspace)
expect(settings.setSafeDirectory).toBe(true)
+ expect(settings.reference).toBe(undefined)
})
it('qualifies ref', async () => {
diff --git a/action.yml b/action.yml
index 6842eb8..577fffc 100644
--- a/action.yml
+++ b/action.yml
@@ -80,6 +80,12 @@ inputs:
show-progress:
description: 'Whether to show progress status output when fetching.'
default: true
+ reference:
+ required: false
+ description: >
+ Path to a local bare git [reference repository to minimize network usage](https://git-scm.com/docs/git-clone#Documentation/git-clone.txt---reference-if-ableltrepositorygt).
+
+ If the directory doesn't exists this option will ignore it and log a message.
lfs:
description: 'Whether to download Git-LFS files'
default: false
diff --git a/dist/index.js b/dist/index.js
index b0db713..3f0a478 100644
--- a/dist/index.js
+++ b/dist/index.js
@@ -748,6 +748,13 @@ class GitCommandManager {
yield this.execGit(['remote', 'add', remoteName, remoteUrl]);
});
}
+ referenceAdd(alternateObjects) {
+ return __awaiter(this, void 0, void 0, function* () {
+ const alternatePath = path.join(this.workingDirectory, '.git/objects/info/alternates');
+ core.info(`Adding a git alternate to reference repo at ${alternateObjects}`);
+ yield fs.promises.writeFile(alternatePath, `${alternateObjects}\n`);
+ });
+ }
removeEnvironmentVariable(name) {
delete this.gitEnv[name];
}
@@ -1239,6 +1246,17 @@ function getSource(settings) {
yield git.init();
yield git.remoteAdd('origin', repositoryUrl);
core.endGroup();
+ if (settings.reference !== undefined) {
+ const alternateObjects = path.join(settings.reference, '/objects');
+ if (fsHelper.directoryExistsSync(alternateObjects, false)) {
+ core.startGroup('Adding a reference repository');
+ yield git.referenceAdd(alternateObjects);
+ core.endGroup();
+ }
+ else {
+ core.warning(`Reference repository was specified, but directory ${alternateObjects} does not exists`);
+ }
+ }
}
// Disable automatic garbage collection
core.startGroup('Disabling automatic garbage collection');
@@ -1831,6 +1849,8 @@ function getInputs() {
// Determine the GitHub URL that the repository is being hosted from
result.githubServerUrl = core.getInput('github-server-url');
core.debug(`GitHub Host URL = ${result.githubServerUrl}`);
+ result.reference = core.getInput('reference');
+ core.debug(`Reference repository = ${result.reference}`);
return result;
});
}
diff --git a/src/git-command-manager.ts b/src/git-command-manager.ts
index 8e42a38..45ce68c 100644
--- a/src/git-command-manager.ts
+++ b/src/git-command-manager.ts
@@ -48,6 +48,7 @@ export interface IGitCommandManager {
lfsInstall(): Promise<void>
log1(format?: string): Promise<string>
remoteAdd(remoteName: string, remoteUrl: string): Promise<void>
+ referenceAdd(reference: string): Promise<void>
removeEnvironmentVariable(name: string): void
revParse(ref: string): Promise<string>
setEnvironmentVariable(name: string, value: string): void
@@ -364,6 +365,15 @@ class GitCommandManager {
await this.execGit(['remote', 'add', remoteName, remoteUrl])
}
+ async referenceAdd(alternateObjects: string): Promise<void> {
+ const alternatePath = path.join(
+ this.workingDirectory,
+ '.git/objects/info/alternates'
+ )
+ core.info(`Adding a git alternate to reference repo at ${alternateObjects}`)
+ await fs.promises.writeFile(alternatePath, `${alternateObjects}\n`)
+ }
+
removeEnvironmentVariable(name: string): void {
delete this.gitEnv[name]
}
diff --git a/src/git-source-provider.ts b/src/git-source-provider.ts
index 2d35138..81805e6 100644
--- a/src/git-source-provider.ts
+++ b/src/git-source-provider.ts
@@ -113,6 +113,18 @@ export async function getSource(settings: IGitSourceSettings): Promise<void> {
await git.init()
await git.remoteAdd('origin', repositoryUrl)
core.endGroup()
+
+ if (settings.reference !== undefined) {
+ const alternateObjects = path.join(settings.reference, '/objects')
+
+ if (fsHelper.directoryExistsSync(alternateObjects, false)) {
+ core.startGroup('Adding a reference repository')
+ await git.referenceAdd(alternateObjects)
+ core.endGroup()
+ } else {
+ core.warning(`Reference repository was specified, but directory ${alternateObjects} does not exists`);
+ }
+ }
}
// Disable automatic garbage collection
diff --git a/src/git-source-settings.ts b/src/git-source-settings.ts
index 4e41ac3..00cbada 100644
--- a/src/git-source-settings.ts
+++ b/src/git-source-settings.ts
@@ -49,6 +49,11 @@ export interface IGitSourceSettings {
*/
fetchDepth: number
+ /**
+ * The local reference repository
+ */
+ reference: string | undefined
+
/**
* Fetch tags, even if fetchDepth > 0 (default: false)
*/
@@ -59,6 +64,11 @@ export interface IGitSourceSettings {
*/
showProgress: boolean
+ /**
+ * The local reference repository
+ */
+ reference: string | undefined
+
/**
* Indicates whether to fetch LFS objects
*/
diff --git a/src/input-helper.ts b/src/input-helper.ts
index 059232f..e65d38a 100644
--- a/src/input-helper.ts
+++ b/src/input-helper.ts
@@ -161,5 +161,8 @@ export async function getInputs(): Promise<IGitSourceSettings> {
result.githubServerUrl = core.getInput('github-server-url')
core.debug(`GitHub Host URL = ${result.githubServerUrl}`)
+ result.reference = core.getInput('reference')
+ core.debug(`Reference repository = ${result.reference}`)
+
return result
}