Skip to content

Commit bbf8a4e

Browse files
authored
chore: "Revert Support GitHub Enterprise Cloud with Data Residency " (#4389)
Reverts #4367 Broken CI: https://github.com/github-aws-runners/terraform-aws-github-runner/actions/runs/13007945341/job/36278943305 @neethu-p can you have a look?
1 parent e5ebd5f commit bbf8a4e

File tree

14 files changed

+28
-351
lines changed

14 files changed

+28
-351
lines changed

README.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ This [Terraform](https://www.terraform.io/) module creates the required infrastr
2525
- Tailored software, hardware and network configuration: Bring your own AMI, define the instance types and subnets to use.
2626
- OS support: Linux (x64/arm64) and Windows
2727
- Multi-Runner: Create multiple runner configurations with a single deployment
28-
- GitHub cloud, Github Cloud with Data Residency and GitHub Enterprise Server (GHES) support.
28+
- GitHub cloud and GitHub Enterprise Server (GHES) support.
2929
- Org and repo level runners. enterprise level runners are not supported (yet).
3030

3131

@@ -140,7 +140,7 @@ Join our discord community via [this invite link](https://discord.gg/bxgXW8jJGh)
140140
| <a name="input_enable_userdata"></a> [enable\_userdata](#input\_enable\_userdata) | Should the userdata script be enabled for the runner. Set this to false if you are using your own prebuilt AMI. | `bool` | `true` | no |
141141
| <a name="input_eventbridge"></a> [eventbridge](#input\_eventbridge) | Enable the use of EventBridge by the module. By enabling this feature events will be put on the EventBridge by the webhook instead of directly dispatching to queues for scaling.<br/><br/> `enable`: Enable the EventBridge feature.<br/> `accept_events`: List can be used to only allow specific events to be putted on the EventBridge. By default all events, empty list will be be interpreted as all events. | <pre>object({<br/> enable = optional(bool, true)<br/> accept_events = optional(list(string), null)<br/> })</pre> | `{}` | no |
142142
| <a name="input_ghes_ssl_verify"></a> [ghes\_ssl\_verify](#input\_ghes\_ssl\_verify) | GitHub Enterprise SSL verification. Set to 'false' when custom certificate (chains) is used for GitHub Enterprise Server (insecure). | `bool` | `true` | no |
143-
| <a name="input_ghes_url"></a> [ghes\_url](#input\_ghes\_url) | GitHub Enterprise Server URL. Example: https://github.internal.co - DO NOT SET IF USING PUBLIC GITHUB - github.com. However if you are using Github Enterprise Cloud with data-residency (ghe.com), set the endpoint here. Example - https://companyname.ghe.com | `string` | `null` | no |
143+
| <a name="input_ghes_url"></a> [ghes\_url](#input\_ghes\_url) | GitHub Enterprise Server URL. Example: https://github.internal.co - DO NOT SET IF USING PUBLIC GITHUB | `string` | `null` | no |
144144
| <a name="input_github_app"></a> [github\_app](#input\_github\_app) | GitHub app parameters, see your github app. Ensure the key is the base64-encoded `.pem` file (the output of `base64 app.private-key.pem`, not the content of `private-key.pem`). | <pre>object({<br/> key_base64 = string<br/> id = string<br/> webhook_secret = string<br/> })</pre> | n/a | yes |
145145
| <a name="input_idle_config"></a> [idle\_config](#input\_idle\_config) | List of time periods, defined as a cron expression, to keep a minimum amount of runners active instead of scaling down to 0. By defining this list you can ensure that in time periods that match the cron expression within 5 seconds a runner is kept idle. | <pre>list(object({<br/> cron = string<br/> timeZone = string<br/> idleCount = number<br/> evictionStrategy = optional(string, "oldest_first")<br/> }))</pre> | `[]` | no |
146146
| <a name="input_instance_allocation_strategy"></a> [instance\_allocation\_strategy](#input\_instance\_allocation\_strategy) | The allocation strategy for spot instances. AWS recommends using `price-capacity-optimized` however the AWS default is `lowest-price`. | `string` | `"lowest-price"` | no |

docs/configuration.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ To be able to support a number of use-cases, the module has quite a lot of confi
1010
- Linux vs Windows. You can configure the OS types linux and win. Linux will be used by default.
1111
- Re-use vs Ephemeral. By default runners are re-used, until detected idle. Once idle they will be removed from the pool. To improve security we are introducing ephemeral runners. Those runners are only used for one job. Ephemeral runners only work in combination with the workflow job event. For ephemeral runners the lambda requests a JIT (just in time) configuration via the GitHub API to register the runner. [JIT configuration](https://docs.github.com/en/actions/security-guides/security-hardening-for-github-actions#using-just-in-time-runners) is limited to ephemeral runners (and currently not supported by GHES). For non-ephemeral runners, a registration token is always requested. In both cases the configuration is made available to the instance via the same SSM parameter. To disable JIT configuration for ephemeral runners set `enable_jit_config` to `false`. We also suggest using a pre-build AMI to improve the start time of jobs for ephemeral runners.
1212
- Job retry (**Beta**). By default the scale-up lambda will discard the message when it is handled. Meaning in the ephemeral use-case an instance is created. The created runner will ask GitHub for a job, no guarantee it will run the job for which it was scaling. Result could be that with small system hick-up the job is keeping waiting for a runner. Enable a pool (org runners) is one option to avoid this problem. Another option is to enable the job retry function. Which will retry the job after a delay for a configured number of times.
13-
- GitHub Cloud vs GitHub Enterprise Server (GHES). The runners support GitHub Cloud (Public GitHub - github.com), GitHub Data Residency instances (ghe.com), and GitHub Enterprise Server. For GHES, we rely on our community for support and testing. We have no capability to test GHES ourselves.
13+
- GitHub Cloud vs GitHub Enterprise Server (GHES). The runners support GitHub Cloud as well GitHub Enterprise Server. For GHES, we rely on our community for support and testing. We have no capability to test GHES ourselves.
1414
- Spot vs on-demand. The runners use either the EC2 spot or on-demand life cycle. Runners will be created via the AWS [CreateFleet API](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateFleet.html). The module (scale up lambda) will request via the CreateFleet API to create instances in one of the subnets and of the specified instance types.
1515
- ARM64 support via Graviton/Graviton2 instance-types. When using the default example or top-level module, specifying `instance_types` that match a Graviton/Graviton 2 (ARM64) architecture (e.g. a1, t4g or any 6th-gen `g` or `gd` type), you must also specify `runner_architecture = "arm64"` and the sub-modules will be automatically configured to provision with ARM64 AMIs and leverage GitHub's ARM64 action runner. See below for more details.
1616
- Disable default labels for the runners (os, architecture and `self-hosted`) can achieve by setting `runner_disable_default_labels` = true. If enabled, the runner will only have the extra labels provided in `runner_extra_labels`. In case you on own start script is used, this configuration parameter needs to be parsed via SSM.

lambdas/functions/control-plane/src/pool/pool.test.ts

-16
Original file line numberDiff line numberDiff line change
@@ -254,22 +254,6 @@ describe('Test simple pool.', () => {
254254
});
255255
});
256256

257-
describe('With Github Data Residency', () => {
258-
beforeEach(() => {
259-
process.env.GHES_URL = 'https://companyname.ghe.com';
260-
});
261-
262-
it('Top up if the pool size is set to 5', async () => {
263-
await expect(await adjust({ poolSize: 5 })).resolves;
264-
// 2 idle, top up with 3 to match a pool of 5
265-
expect(createRunners).toHaveBeenCalledWith(
266-
expect.anything(),
267-
expect.objectContaining({ numberOfRunners: 3 }),
268-
expect.anything(),
269-
);
270-
});
271-
});
272-
273257
describe('With Runner Name Prefix', () => {
274258
beforeEach(() => {
275259
process.env.RUNNER_NAME_PREFIX = 'runner-prefix_';

lambdas/functions/control-plane/src/pool/pool.ts

+6-2
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ import yn from 'yn';
55
import { bootTimeExceeded, listEC2Runners } from '../aws/runners';
66
import { RunnerList } from '../aws/runners.d';
77
import { createGithubAppAuth, createGithubInstallationAuth, createOctokitClient } from '../github/auth';
8-
import { createRunners, getGitHubEnterpriseApiUrl } from '../scale-runners/scale-up';
8+
import { createRunners } from '../scale-runners/scale-up';
99

1010
const logger = createChildLogger('pool');
1111

@@ -24,6 +24,7 @@ export async function adjust(event: PoolEvent): Promise<void> {
2424
const runnerGroup = process.env.RUNNER_GROUP_NAME || '';
2525
const runnerNamePrefix = process.env.RUNNER_NAME_PREFIX || '';
2626
const environment = process.env.ENVIRONMENT;
27+
const ghesBaseUrl = process.env.GHES_URL;
2728
const ssmTokenPath = process.env.SSM_TOKEN_PATH;
2829
const ssmConfigPath = process.env.SSM_CONFIG_PATH || '';
2930
const subnets = process.env.SUBNET_IDS.split(',');
@@ -42,7 +43,10 @@ export async function adjust(event: PoolEvent): Promise<void> {
4243
? (JSON.parse(process.env.ENABLE_ON_DEMAND_FAILOVER_FOR_ERRORS) as [string])
4344
: [];
4445

45-
const { ghesApiUrl, ghesBaseUrl } = getGitHubEnterpriseApiUrl();
46+
let ghesApiUrl = '';
47+
if (ghesBaseUrl) {
48+
ghesApiUrl = `${ghesBaseUrl}/api/v3`;
49+
}
4650

4751
const installationId = await getInstallationId(ghesApiUrl, runnerOwner);
4852
const ghAuth = await createGithubInstallationAuth(installationId, ghesApiUrl);

lambdas/functions/control-plane/src/scale-runners/job-retry.ts

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
import { addPersistentContextToChildLogger, createSingleMetric, logger } from '@aws-github-runner/aws-powertools-util';
22
import { publishMessage } from '../aws/sqs';
3-
import { ActionRequestMessage, ActionRequestMessageRetry, isJobQueued ,getGitHubEnterpriseApiUrl} from './scale-up';
3+
import { ActionRequestMessage, ActionRequestMessageRetry, getGitHubEnterpriseApiUrl, isJobQueued } from './scale-up';
44
import { getOctokit } from '../github/octokit';
55
import { MetricUnit } from '@aws-lambda-powertools/metrics';
66
import yn from 'yn';

lambdas/functions/control-plane/src/scale-runners/scale-down.test.ts

+2-2
Original file line numberDiff line numberDiff line change
@@ -159,11 +159,11 @@ describe('Scale down runners', () => {
159159
mockCreateClient.mockResolvedValue(new mocktokit());
160160
});
161161

162-
const endpoints = ['https://api.github.com', 'https://github.enterprise.something', 'https://companyname.ghe.com'];
162+
const endpoints = ['https://api.github.com', 'https://github.enterprise.something'];
163163

164164
describe.each(endpoints)('for %s', (endpoint) => {
165165
beforeEach(() => {
166-
if (endpoint.includes('enterprise') || endpoint.endsWith('.ghe.com')) {
166+
if (endpoint.includes('enterprise')) {
167167
process.env.GHES_URL = endpoint;
168168
}
169169
});

lambdas/functions/control-plane/src/scale-runners/scale-down.ts

+5-2
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,6 @@ import { RunnerInfo, RunnerList } from './../aws/runners.d';
88
import { GhRunners, githubCache } from './cache';
99
import { ScalingDownConfig, getEvictionStrategy, getIdleRunnerCount } from './scale-down-config';
1010
import { metricGitHubAppRateLimit } from '../github/rate-limit';
11-
import {getGitHubEnterpriseApiUrl} from './scale-up';
1211

1312
const logger = createChildLogger('scale-down');
1413

@@ -22,7 +21,11 @@ async function getOrCreateOctokit(runner: RunnerInfo): Promise<Octokit> {
2221
}
2322

2423
logger.debug(`[createGitHubClientForRunner] Cache miss for ${key}`);
25-
const { ghesApiUrl} = getGitHubEnterpriseApiUrl();
24+
const ghesBaseUrl = process.env.GHES_URL;
25+
let ghesApiUrl = '';
26+
if (ghesBaseUrl) {
27+
ghesApiUrl = `${ghesBaseUrl}/api/v3`;
28+
}
2629
const ghAuthPre = await createGithubAppAuth(undefined, ghesApiUrl);
2730
const githubClientPre = await createOctokitClient(ghAuthPre.token, ghesApiUrl);
2831

0 commit comments

Comments
 (0)