From 66fab72269707de1a6bc382cfc46789f5edd6f8e Mon Sep 17 00:00:00 2001 From: Kristen Foster-Marks Date: Fri, 15 Nov 2024 11:15:08 -0700 Subject: [PATCH 1/6] docs: update gha overview & quick start --- content/github-actions/overview.mdx | 10 +++++----- content/github-actions/quickstart.mdx | 16 +++++++++------- 2 files changed, 14 insertions(+), 12 deletions(-) diff --git a/content/github-actions/overview.mdx b/content/github-actions/overview.mdx index de8cd61..8d75c5e 100644 --- a/content/github-actions/overview.mdx +++ b/content/github-actions/overview.mdx @@ -1,17 +1,17 @@ --- title: Faster GitHub Actions Runners -ogTitle: Overview of Depot managed GitHub Action Runners -description: Overview of Depot managed GitHub Action Runners with 30% faster compute, 10x faster caching, and half the cost of GitHub hosted runners per minute. +ogTitle: Overview of Depot-managed GitHub Action Runners +description: Overview of Depot-managed GitHub Action Runners with 30% faster compute, 10x faster caching, and half the cost of GitHub hosted runners per minute. --- Our fully-managed GitHub Actions Runners are a simple drop-in replacement for your existing runners in any GitHub Action jobs. Our runners have 30% faster compute, 10x faster caching and are half the cost of GitHub hosted runners. Here are a few technical and implementation details that are relevant for Depot-managed GitHub Actions runners: -- **Single tenant**: Runners are single tenant, we run your job and then kill the machine, it's never reused +- **Single tenant**: Runners are single tenant. We run your job and then kill the machine - it's never reused - **30% faster compute**: For Intel runners, we launched with 4th Gen AMD EPYC Genoa CPUs and for Arm runners, we launched with AWS Graviton2 CPUs - **10x faster cache**: Runners automatically integrate with our distributed cache architecture for upload and download speeds up to 1000 MiB/s on 12.5 Gbps of network throughput — no 10GB cache limit either -- **Per second billing**: We track builds by the second and only bill for whole minutes used at the end of the month and don't enforce a one minute minimum +- **Per second billing**: We track builds by the second and only bill for whole minutes used at the end of the month - and we don't enforce a one minute minimum - **No limits**: No concurrency limits, no cache size limits, and no network limits - **Self-hostable**: We can run our optimized runners in our cloud or your AWS account for additional security and compliance @@ -19,7 +19,7 @@ In addition, if you use Depot for faster Docker image builds via our [remote con ## Pricing -Depot managed GitHub Action Runners are available on [all of our pricing plans](/pricing). Each plan includes a bucket of both of Docker build minutes and GitHub Actions minutes. Business plan customers can [contact us](mailto:help@depot.dev) for custom plans. +Depot-managed GitHub Action Runners are available on [all of our pricing plans](/pricing). Each plan includes a bucket of both Docker build minutes and GitHub Actions minutes. Business plan customers can [contact us](mailto:help@depot.dev) for custom plans. | | Developer | Startup | | ------------------------------- | :-------- | :--------------------------- | diff --git a/content/github-actions/quickstart.mdx b/content/github-actions/quickstart.mdx index 204bc57..ac40ba2 100644 --- a/content/github-actions/quickstart.mdx +++ b/content/github-actions/quickstart.mdx @@ -10,7 +10,7 @@ Below is a quickstart guide for connecting your Depot organization to GitHub and If you have not already created an Organization, you will need to create one before proceeding. Organizations are the top-level entity in Depot. They typically represent a single company or team. Billing details are attached to an organization. -1. Login to your Depot account to get to your [list of organizations](/orgs) +1. Log in to your Depot account to get to your [list of organizations](/orgs) 2. Click on the `Create Organization` button 3. Enter an organization name 4. Click `Create organization` @@ -33,7 +33,13 @@ If you're going to use Depot runners with public repositories, you will need to ## Configure your GitHub Actions workflow -Once Depot is connected to your GitHub organization and the application is approved, you can configure your GitHub Actions to use the runners by specifying the `runs-on` key in your workflow file. +### Depot-supported labels + +Depot supports a variety of different runner types and sizes depending on your CI job needs, including Intel and Arm runners with up to 64 CPUs, and I/O-optimized runners with local NVMe disks. See the [runner type docs](/docs/github-actions/runner-types) for a full list of available labels. + +### + +Once Depot is connected to your GitHub organization and the application is approved, you can configure your GitHub Actions to use your chosen runners by specifying the runner label in your `.github/workflows/` file. ```diff jobs: @@ -45,10 +51,6 @@ jobs: ... ``` -### Depot supported labels - -Depot supports a variety of different runner types and sizes depending on your CI job needs, including Intel and Arm runners with up to 64 CPUs, and I/O-optimized runners with local NVMe disks. See the [runner type docs](/docs/github-actions/runner-types) for a full list of available labels. - ## View GitHub Actions jobs After configuring your GitHub Actions workflow to use Depot runners, you can view the jobs that have run on Depot runners in your organization's `GitHub Actions` tab. @@ -57,6 +59,6 @@ After configuring your GitHub Actions workflow to use Depot runners, you can vie ## View GitHub Actions usage -Once you've started running GitHub Actions jobs on Depot runners, you can view the usage information in your organization's `Usage` tab. This includes the number of jobs, total job time, success and errors, build time, and cache storage used. +Once you've started running GitHub Actions jobs on Depot runners, you can view the usage information in your organization's `Usage` tab. This includes the number of jobs, total job time, successes and errors, build time, and cache storage used. ![View GitHub Actions usage](/images/docs/github-actions-usage.png) From 6bfc52700717a992870457d14fee5580206f5250 Mon Sep 17 00:00:00 2001 From: Kristen Foster-Marks Date: Fri, 15 Nov 2024 11:22:29 -0700 Subject: [PATCH 2/6] docs: additional gha updates --- content/github-actions/quickstart.mdx | 2 +- content/github-actions/runner-types.mdx | 14 ++++++++------ 2 files changed, 9 insertions(+), 7 deletions(-) diff --git a/content/github-actions/quickstart.mdx b/content/github-actions/quickstart.mdx index ac40ba2..ca99ba6 100644 --- a/content/github-actions/quickstart.mdx +++ b/content/github-actions/quickstart.mdx @@ -39,7 +39,7 @@ Depot supports a variety of different runner types and sizes depending on your C ### -Once Depot is connected to your GitHub organization and the application is approved, you can configure your GitHub Actions to use your chosen runners by specifying the runner label in your `.github/workflows/` file. +Once Depot is connected to your GitHub organization and the application is approved, you can configure your GitHub Actions to use your chosen runners by specifying the runner label in your `.github/workflows/*.yaml` file. ```diff jobs: diff --git a/content/github-actions/runner-types.mdx b/content/github-actions/runner-types.mdx index 1ecd02a..e39517a 100644 --- a/content/github-actions/runner-types.mdx +++ b/content/github-actions/runner-types.mdx @@ -1,10 +1,10 @@ --- title: GitHub Actions Runner Types -ogTitle: Types of Depot managed GitHub Action Runners +ogTitle: Types of Depot-managed GitHub Action Runners description: Depot offers several different types of GitHub Actions runners, depending on your CI job needs. --- -Depot offers several different types of GitHub Actions runners, depending on your CI job needs. You can choose the type on a per-job basis by specifying the `runs-on` key in your GitHub Actions workflow file: +Depot offers several different types of GitHub Actions runners, depending on your CI job needs. You can choose the type on a per-job basis by specifying the runner label in your `.github/workflows/*.yaml` file: ```yaml jobs: @@ -16,7 +16,7 @@ jobs: **In-memory Disk Accelerator**: -Depot runners reserve a portion of the memory on the runner host for a disk accelerator, backed by a RAM disk. The accelerator acts as buffer between reading and writing to the root disk, which allows Actions runs to perform incredibly fast I/O operations much quicker than the physical disk would allow. +Depot runners reserve a portion of the memory on the runner host for a disk accelerator, backed by a RAM disk. The accelerator acts as buffer between reading and writing to the root disk, which allows Actions runs to perform incredibly fast I/O operations, much quicker than the physical disk would allow. ## Intel runners @@ -52,7 +52,9 @@ The following labels are available: ## Ubuntu 24.04 runners -These runners use the same instances as the Ubuntu 22.04 runners. The following labels are available: +These runners use the same instances as the Ubuntu 22.04 runners. + +The following labels are available: | Label | CPUs | Memory | Disk size | Disk accelerator size | Per-minute price | Minutes multiplier | | :----------------------------- | :--- | :----- | :-------- | :-------------------- | :--------------- | :----------------- | @@ -79,7 +81,7 @@ macOS runners use instances with M2 chips running macOS 14. Their EBS volume is **Note**: These runners are only available on the [Startup plan](/pricing) during beta. -The following label is available: +The following labels are available: | Label | CPUs | Memory | Disk size | Per-minute price | | :------------------- | :--- | :----- | :-------- | :--------------- | @@ -88,6 +90,6 @@ The following label is available: ## Billing -Note that on your Billing summary, costs are broken down by `Billed minutes` and `Elapsed minutes`. `Elapsed minutes` is the wall time spent executing your Jobs, `Billed minutes` multiples the `Minutes multiplier` (from the table above) to the Elapsed minutes. +Note that on your Billing summary, costs are broken down by `Billed minutes` and `Elapsed minutes`. `Elapsed minutes` is the clock time spent executing your Jobs. `Billed minutes` multiples the `Minutes multiplier` (from the table above) to the Elapsed minutes. Therefore, you will burn `Billed minutes` faster based on the size of the `Minutes multiplier`. Finally, what you pay is the total `Billed minutes` minus the included minutes of your Plan. From 9c20772585a87d0bb6e3cf9cea3a4a89898aec79 Mon Sep 17 00:00:00 2001 From: Kristen Foster-Marks Date: Fri, 15 Nov 2024 11:24:02 -0700 Subject: [PATCH 3/6] docs: run prettier --- content/github-actions/quickstart.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/github-actions/quickstart.mdx b/content/github-actions/quickstart.mdx index ca99ba6..c6ba79a 100644 --- a/content/github-actions/quickstart.mdx +++ b/content/github-actions/quickstart.mdx @@ -37,7 +37,7 @@ If you're going to use Depot runners with public repositories, you will need to Depot supports a variety of different runner types and sizes depending on your CI job needs, including Intel and Arm runners with up to 64 CPUs, and I/O-optimized runners with local NVMe disks. See the [runner type docs](/docs/github-actions/runner-types) for a full list of available labels. -### +### Once Depot is connected to your GitHub organization and the application is approved, you can configure your GitHub Actions to use your chosen runners by specifying the runner label in your `.github/workflows/*.yaml` file. From a719eacac574ba9ae507deada5e4da7ab60d85e9 Mon Sep 17 00:00:00 2001 From: Kristen Foster-Marks Date: Fri, 15 Nov 2024 13:58:58 -0700 Subject: [PATCH 4/6] docs: break billing details into bullet format --- content/github-actions/runner-types.mdx | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/content/github-actions/runner-types.mdx b/content/github-actions/runner-types.mdx index e39517a..8818478 100644 --- a/content/github-actions/runner-types.mdx +++ b/content/github-actions/runner-types.mdx @@ -90,6 +90,9 @@ The following labels are available: ## Billing -Note that on your Billing summary, costs are broken down by `Billed minutes` and `Elapsed minutes`. `Elapsed minutes` is the clock time spent executing your Jobs. `Billed minutes` multiples the `Minutes multiplier` (from the table above) to the Elapsed minutes. +Note that on your Billing summary, costs are broken down by `Billed minutes` and `Elapsed minutes`. Here are several things to know about the difference: -Therefore, you will burn `Billed minutes` faster based on the size of the `Minutes multiplier`. Finally, what you pay is the total `Billed minutes` minus the included minutes of your Plan. +- `Elapsed minutes` is the clock time spent executing your jobs. +- `Billed minutes` multiples the `Minutes multiplier` (from the table above) by the `Elapsed minutes`. +- The rate at which `Billed minutes` accumulates is based on the size of the `Minutes multiplier`. +- What you pay is the total `Billed minutes` minus the included minutes of your plan. From 9d1747166ee24ba38abf3668766b48646b3f6f8a Mon Sep 17 00:00:00 2001 From: K-Foster-Marks Date: Mon, 18 Nov 2024 09:14:38 -0700 Subject: [PATCH 5/6] Update to reflect ultra-runner use Co-authored-by: Kyle Galbraith --- content/github-actions/quickstart.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/github-actions/quickstart.mdx b/content/github-actions/quickstart.mdx index c6ba79a..9529404 100644 --- a/content/github-actions/quickstart.mdx +++ b/content/github-actions/quickstart.mdx @@ -35,7 +35,7 @@ If you're going to use Depot runners with public repositories, you will need to ### Depot-supported labels -Depot supports a variety of different runner types and sizes depending on your CI job needs, including Intel and Arm runners with up to 64 CPUs, and I/O-optimized runners with local NVMe disks. See the [runner type docs](/docs/github-actions/runner-types) for a full list of available labels. +Depot supports a variety of different runner types and sizes depending on your CI job needs, including Intel and Arm runners with up to 64 CPUs. See the [runner type docs](/docs/github-actions/runner-types) for a full list of available labels. ### From 752ed9a1427ac37763f52e1540b0b5e77b7ca03e Mon Sep 17 00:00:00 2001 From: Kristen Foster-Marks Date: Mon, 18 Nov 2024 09:17:21 -0700 Subject: [PATCH 6/6] docs: remove floating header --- content/github-actions/quickstart.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/content/github-actions/quickstart.mdx b/content/github-actions/quickstart.mdx index 9529404..ffe857b 100644 --- a/content/github-actions/quickstart.mdx +++ b/content/github-actions/quickstart.mdx @@ -37,8 +37,6 @@ If you're going to use Depot runners with public repositories, you will need to Depot supports a variety of different runner types and sizes depending on your CI job needs, including Intel and Arm runners with up to 64 CPUs. See the [runner type docs](/docs/github-actions/runner-types) for a full list of available labels. -### - Once Depot is connected to your GitHub organization and the application is approved, you can configure your GitHub Actions to use your chosen runners by specifying the runner label in your `.github/workflows/*.yaml` file. ```diff