Skip to content
Merged
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
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -60,13 +60,17 @@ There are some limits on {% data variables.product.prodname_actions %} usage whe

**{% data variables.product.prodname_dotcom %}-hosted {% data variables.actions.hosted_runner %}s**

| GitHub plan | Total concurrent jobs | Maximum concurrent macOS jobs |
|---|---|---|
| All | 1000 | The limit is based on your {% data variables.product.prodname_dotcom %} plan. |
| GitHub plan | Total concurrent jobs | Maximum concurrent macOS jobs | Maximum concurrent GPU jobs |
|---|---|---|---|
| Team | 1000 | 5 | 100 |
| Enterprise | 1000 | 50 | 100 |

{% note %}

**Note:** If required, customers on enterprise plans can request a higher limit for concurrent jobs. For more information, contact us through the {% data variables.contact.contact_support_portal %}, or contact your sales representative.
**Notes:**

- If required, customers on enterprise plans can request a higher limit for concurrent jobs. For more information, contact us through the {% data variables.contact.contact_support_portal %}, or contact your sales representative.
- The maximum concurrent macOS jobs is shared across standard {% data variables.product.prodname_dotcom %}-hosted runner and {% data variables.product.prodname_dotcom %}-hosted {% data variables.actions.hosted_runner %}s.

{% endnote %}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -120,6 +120,8 @@ While the job runs, the logs and output can be viewed in the {% data variables.p

{% data variables.product.prodname_dotcom %}-hosted runners are available for use in both public and private repositories.

{% data variables.product.prodname_dotcom %}-hosted Linux runners support hardware acceleration for Android SDK tools, which makes running Android tests much faster and consumes fewer minutes. For more information on Android hardware acceleration, see [Configure hardware acceleration for the Android Emulator](https://developer.android.com/studio/run/emulator-acceleration) in the Android Developers documentation.

{% note %}

**Note:** The `-latest` runner images are the latest stable images that {% data variables.product.prodname_dotcom %} provides, and might not be the most recent version of the operating system available from the operating system vendor.
Expand Down Expand Up @@ -178,9 +180,7 @@ You can install additional software on {% data variables.product.prodname_dotcom

{% data variables.product.prodname_dotcom %} hosts Linux and Windows runners on virtual machines in Microsoft Azure with the {% data variables.product.prodname_actions %} runner application installed. The {% data variables.product.prodname_dotcom %}-hosted runner application is a fork of the Azure Pipelines Agent. Inbound ICMP packets are blocked for all Azure virtual machines, so ping or traceroute commands might not work. {% data variables.product.prodname_dotcom %} hosts macOS runners in Azure data centers.

{% data variables.product.prodname_dotcom %} provides different Linux and Windows runners for public and private repositories.
- For Linux and Windows runners in **public** repositories, GitHub uses `Standard_D4ads_v5` virtual machines. For more information, see [Dasv5 and Dadsv5-series](https://learn.microsoft.com/en-us/azure/virtual-machines/dasv5-dadsv5-series#dadsv5-series) in the Microsoft Azure documentation.
- For Linux and Windows runners in **private** repositories, GitHub uses `Standard_DS2_v2` virtual machines. For more information, see [Dv2 and DSv2-series](https://learn.microsoft.com/en-us/azure/virtual-machines/dv2-dsv2-series#dsv2-series) in the Microsoft Azure documentation.
For Linux and Windows runners, GitHub uses `Dadsv5-series` virtual machines. For more information, see [Dasv5 and Dadsv5-series](https://learn.microsoft.com/en-us/azure/virtual-machines/dasv5-dadsv5-series#dadsv5-series) in the Microsoft Azure documentation.

## Workflow continuity

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: About larger runners
shortTitle: About larger runners
intro: '{% data variables.product.prodname_dotcom %} offers runners with more RAM, CPU, and disk space.'
intro: '{% data variables.product.prodname_dotcom %} offers runners with advanced features to support more customized use cases.'
permissions: '{% data reusables.actions.larger-runner-permissions %}'
versions:
feature: actions-hosted-runners
Expand All @@ -13,7 +13,7 @@ redirect_from:

{% data reusables.actions.about-larger-runners %}

{% data variables.product.prodname_dotcom %} offers {% data variables.actions.hosted_runners %} with macOS, Ubuntu, or Windows operating systems, and different features are available depending on which operating system you use. For more information, see "[Additional features for {% data variables.actions.hosted_runners %}](#additional-features-for-larger-runners)."
{% data variables.product.prodname_dotcom %} offers {% data variables.actions.hosted_runners %} with macOS, Ubuntu, or Windows operating systems, and different features and sizes are available depending on which operating system you use. For more information, see "[Additional features for {% data variables.actions.hosted_runners %}](#additional-features-for-larger-runners)."

### About Ubuntu and Windows {% data variables.actions.hosted_runners %}

Expand Down Expand Up @@ -45,7 +45,6 @@ Compared to standard {% data variables.product.prodname_dotcom %}-hosted runners

| Operating system | Ubuntu | Windows | macOS |
| -------------------------------------------- | ------ | ------- | ----- |
| Hardware acceleration for Android SDK tools | {% octicon "check" aria-label="Supported" %} | {% octicon "x" aria-label="Not supported" %} | {% octicon "x" aria-label="Not supported" %} |
| Static IP addresses | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} | {% octicon "x" aria-label="Not supported" %} |
| Autoscaling | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} | {% octicon "x" aria-label="Not supported" %} |
| Runner groups | {% octicon "check" aria-label="Supported" %} | {% octicon "check" aria-label="Supported" %} | {% octicon "x" aria-label="Not supported" %} |
Expand All @@ -54,12 +53,11 @@ Compared to standard {% data variables.product.prodname_dotcom %}-hosted runners

These features can enhance your CI/CD pipelines in the following ways.

- Hardware acceleration for the Android SDK tools makes running Android tests much faster and consumes fewer minutes. For more information on Android hardware acceleration, see [Configure hardware acceleration for the Android Emulator](https://developer.android.com/studio/run/emulator-acceleration) in the Android Developers documentation.
- Assigning {% data variables.actions.hosted_runners %} static IP addresses from a specific range enables you to use this range to configure a firewall allowlist. For more information, see "[Networking for {% data variables.actions.hosted_runners %}](#networking-for-larger-runners)."
- Autoscaling enables {% data variables.actions.hosted_runners %} to scale up to a maximum limit set by you, so your workflows can run concurrently. For more information, see "[Autoscaling {% data variables.actions.hosted_runners %}](#autoscaling-larger-runners)."
- Runner groups allow you to control access to {% data variables.actions.hosted_runners %} for your organizations, repositories, and workflows. For more information, see "[AUTOTITLE](/actions/using-github-hosted-runners/controlling-access-to-larger-runners)."

For a full list of included tools for each runner operating system, see the [{% data variables.product.prodname_actions %} Runner Images](https://github.com/actions/runner-images) repository.
For a full list of included tools for each runner operating system (excluding GPU runners), see the [{% data variables.product.prodname_actions %} Runner Images](https://github.com/actions/runner-images) repository. For GPU runners, see [NVIDIA GPU-Optimized VMI](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/nvidia.ngc_azure_17_11) and [Data Science Virtual Machine - Windows 2019](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/microsoft-dsvm.dsvm-win-2019?tab=overview).

### Understanding billing

Expand All @@ -73,15 +71,28 @@ Compared to standard {% data variables.product.prodname_dotcom %}-hosted runners

## Machine sizes for {% data variables.actions.hosted_runners %}

| Processor (CPU)| Memory (RAM) | Storage (SSD) | Operating system (OS) |
| -------------- | ------------- | ------------- | --------------------- |
| 6 | 14 GB | 14 GB | macOS |
| 12 | 30 GB | 14 GB | macOS |
| 4 | 16 GB | 150 GB | Ubuntu |
| 8 | 32 GB | 300 GB | Ubuntu, Windows |
| 16 | 64 GB | 600 GB | Ubuntu, Windows |
| 32 | 128 GB | 1200 GB | Ubuntu, Windows |
| 64 | 256 GB | 2040 GB | Ubuntu, Windows |
You can choose from several specifications for {% data variables.actions.hosted_runners %}.

### Specifications for general {% data variables.actions.hosted_runners %}

| CPU | Memory (RAM) | Storage (SSD) | Operating system (OS) |
| --- | ------------- | ------------- | --------------------- |
| 6 | 14 GB | 14 GB | macOS |
| 12 | 30 GB | 14 GB | macOS |
| 2 | 8 GB | 14 GB | Ubuntu |
| 4 | 16 GB | 150 GB | Ubuntu, Windows |
| 8 | 32 GB | 300 GB | Ubuntu, Windows |
| 16 | 64 GB | 600 GB | Ubuntu, Windows |
| 32 | 128 GB | 1200 GB | Ubuntu, Windows |
| 64 | 256 GB | 2040 GB | Ubuntu, Windows |

### Specifications for GPU {% data variables.actions.hosted_runners %}

{% data reusables.actions.gpu-runner-beta-note %}

| CPU | GPU | GPU card | Memory (RAM) | GPU memory (VRAM) | Storage (SSD) | Operating system (OS) |
| --- | --- | -------- | ------------ | ----------------- | ------------- | --------------------- |
| 4 | 1 | Tesla T4 | 28 GB | 16 GB | 176 GB | Ubuntu, Windows |

## About runner groups

Expand Down Expand Up @@ -123,15 +134,15 @@ In the following diagram, a class of hosted runner named `ubuntu-20.04-16core` h

{% data variables.actions.hosted_runner_caps %}s can automatically scale to suit your needs. You can provision machines to run a specified maximum number of jobs when jobs are submitted for processing. Each machine only handles one job at a time, so these settings effectively determine the number of jobs that can be run concurrently.

You can configure the maximum job concurrency, which allows you to control your costs by setting the maximum parallel number of jobs that can be run using this set. A higher value here can help avoid workflows being blocked due to parallelism. For more information, see "[AUTOTITLE](/actions/using-github-hosted-runners/managing-larger-runners#configuring-autoscaling-for-larger-runners)."
You can configure the maximum job concurrency, which allows you to control your costs by setting the maximum parallel number of jobs that can be run using this set. A higher value here can help avoid workflows being blocked due to parallelism. For more information on how to set limits, see "[AUTOTITLE](/actions/using-github-hosted-runners/managing-larger-runners#configuring-autoscaling-for-larger-runners)". For more information on the maximum auto-scaling limits for {% data variables.product.company_short %}-hosted runners, see "[AUTOTITLE](/actions/learn-github-actions/usage-limits-billing-and-administration#usage-limits)."

## Networking for {% data variables.actions.hosted_runners %}

{% note %}

**Notes:**
- Assigning static IP addresses to runners is only available for {% data variables.actions.hosted_runners %} with Linux or Windows operating systems.
- {% data reusables.actions.static-ip-limitation-vnet %} For more information about private networking for {% data variables.product.company_short %}-hosted runners, see "[AUTOTITLE](/admin/configuration/configuring-private-networking-for-hosted-compute-products/about-using-github-hosted-runners-in-your-azure-virtual-network)."
- {% data reusables.actions.static-ip-limitation-vnet %} For more information about private networking for {% data variables.product.company_short %}-hosted runners, see "[AUTOTITLE](/admin/configuration/configuring-private-networking-for-hosted-compute-products/about-azure-private-networking-for-github-hosted-runners-in-your-enterprise)."

{% endnote %}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -84,16 +84,6 @@ For runner groups in an organization, you can change what repositories in the or
- [Changing which workflows can access an organization runner group](#changing-which-workflows-can-access-an-organization-runner-group)
- [Changing which workflows can access an enterprise runner group](#changing-which-workflows-can-access-an-enterprise-runner-group)

{% ifversion actions-private-networking-azure-vnet %}

## Configuring private network access for larger runners

{% data reusables.actions.azure-vnet-injected-runners-intro %}

If you have configured your enterprise to connect to an Azure VNET, you can give runner groups access to the virtual network. For more information, see "[AUTOTITLE](/actions/using-github-hosted-runners/connecting-to-a-private-network#using-an-azure-virtual-network-vnet)."

{% endif %}

### Changing which workflows can access an organization runner group

{% data reusables.actions.runner-groups-org-navigation %}
Expand All @@ -106,6 +96,16 @@ If you have configured your enterprise to connect to an Azure VNET, you can give

{% endif %}

{% ifversion actions-private-networking-azure-vnet %}

## Configuring private network access for larger runners

{% data reusables.actions.azure-vnet-network-configuration-intro %}

If you have configured your {% ifversion ghec %}enterprise or {% endif %}organization to connect to an Azure VNET, you can give runner groups access to the virtual network. For more information, see "[AUTOTITLE](/actions/using-github-hosted-runners/connecting-to-a-private-network/about-private-networking-with-github-hosted-runners#using-an-azure-virtual-network-vnet)."

{% endif %}

## Changing the name of a runner group

{% ifversion ghec %}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ redirect_from:

{% data reusables.actions.windows-linux-larger-runners-note %}

{% data reusables.actions.gpu-runner-beta-note %}

{% ifversion ghec %}

## Adding a {% data variables.actions.hosted_runner %} to an enterprise
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,12 @@ versions:
type: overview
topics:
- Actions
- Action development
- Azure Virtual Network
- Administrator
- Developer
- CI
- CD
---

{% data reusables.actions.enterprise-github-hosted-runners %}
Expand All @@ -18,7 +23,7 @@ topics:

{% data reusables.actions.about-private-networking-github-hosted-runners %}

There are a few different approaches you could take to configure this access, each with different advantages and disadvantages.
There are a few different approaches you could take to configure this access, each with different advantages and disadvantages.

## Using an API Gateway with OIDC

Expand All @@ -32,8 +37,24 @@ topics:

## Using an Azure Virtual Network (VNET)

{% data reusables.actions.private-networking-actions-azure-vnet-beta-note %}
{% data reusables.actions.azure-vnet-network-configuration-intro %}

{% data reusables.actions.azure-vnet-injected-runners-intro %} For more information, see "[AUTOTITLE](/admin/configuration/configuring-private-networking-for-hosted-compute-products/about-using-github-hosted-runners-in-your-azure-virtual-network)."
{% ifversion fpt %}

Organization owners using the {% data variables.product.prodname_team %} plan can configure {% data variables.product.company_short %}-hosted runners at the organization level. For more information, see "[AUTOTITLE](/organizations/managing-organization-settings/about-azure-private-networking-for-github-hosted-runners-in-your-organization)."

Enterprise owners using {% data variables.product.prodname_ghe_cloud %} can configure Azure private networking at the enterprise level. For more information about upgrading to {% data variables.product.prodname_ghe_cloud %}, see "[AUTOTITLE](/billing/managing-the-plan-for-your-github-account/upgrading-your-accounts-plan)."

For more information about configuring Azure private networking at the enterprise level, see "[AUTOTITLE](/enterprise-cloud@latest/admin/configuration/configuring-private-networking-for-hosted-compute-products/about-azure-private-networking-for-github-hosted-runners-in-your-enterprise)."

{% endif %}

{% ifversion ghec %}

Enterprise owners can configure Azure private networking at the enterprise level. For more information, see "[AUTOTITLE](/enterprise-cloud@latest/admin/configuration/configuring-private-networking-for-hosted-compute-products/about-azure-private-networking-for-github-hosted-runners-in-your-enterprise)."

Organization owners for organizations in an enterprise can configure {% data variables.product.company_short %}-hosted runners at the organization level. For more information, see "[AUTOTITLE](/organizations/managing-organization-settings/about-azure-private-networking-for-github-hosted-runners-in-your-organization)."

{% endif %}

{% endif %}
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,15 @@ shortTitle: Manage GitHub Advanced Security

## About management of {% data variables.product.prodname_advanced_security %} features

You can use {% data variables.product.prodname_advanced_security %} features to harden security for the organizations in your enterprise. To streamline management of {% data variables.product.prodname_advanced_security %}, you can enable or disable each feature for all existing and/or new repositories within the organizations owned by your enterprise.
You can use {% data variables.product.prodname_advanced_security %} features to harden security for the organizations in your enterprise. {% ifversion security-configurations %}{% data reusables.security-configurations.enable-security-features-with-gh-config %}

{% note %}

**Note:** {% data reusables.security-configurations.security-configurations-beta-note-short %}

{% endnote %}

To manage individual {% data variables.product.prodname_GH_advanced_security %} features, {% else %}To streamline management of {% data variables.product.prodname_advanced_security %}, {% endif %}you can enable or disable each feature for all existing and/or new repositories within the organizations owned by your enterprise.

{% ifversion secret-scanning-enterprise-level-api %}{% data reusables.secret-scanning.secret-scanning-enterprise-level-api %}{% endif %}

Expand Down
Loading