Skip to content

Commit c275c78

Browse files
committed
[Workers] Nav changes - batch 1
1 parent 50c753e commit c275c78

File tree

16 files changed

+184
-126
lines changed

16 files changed

+184
-126
lines changed

src/content/docs/workers/ci-cd/builds/index.mdx

Lines changed: 20 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,10 @@ pcx_content_type: concept
33
title: Builds
44
description: Use Workers Builds to integrate with Git and automatically build and deploy your Worker when pushing a change
55
sidebar:
6-
group:
76
badge:
87
text: Beta
98
---
9+
import { DashButton } from "~/components";
1010

1111
The Cloudflare [Git integration](/workers/ci-cd/builds/git-integration/) lets you connect a new or existing Worker to a GitHub or GitLab repository, enabling automated builds and deployments for your Worker on push.
1212

@@ -15,9 +15,12 @@ The Cloudflare [Git integration](/workers/ci-cd/builds/git-integration/) lets yo
1515
### Connect a new Worker
1616

1717
To create a new Worker and connect it to a GitHub or GitLab repository:
18-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com) and select your account.
19-
2. Go to **Workers & Pages**.
20-
3. Select **Create**.
18+
1. In the Cloudflare dashboard, go to the **Workers & Pages** page.
19+
20+
<DashButton url="/?to=/:account/workers-and-pages" />
21+
22+
2. Select **Create application**.
23+
3. Select **Get started** next to **Import a repository**.
2124
4. Under **Import a repository**, select a **Git account**.
2225
5. Select the repository you want to import from the list. You can also use the search bar to narrow the results.
2326
6. Configure your project and select **Save and Deploy**.
@@ -26,12 +29,14 @@ To create a new Worker and connect it to a GitHub or GitLab repository:
2629
### Connect an existing Worker
2730

2831
To connect an existing Worker to a GitHub or GitLab repository:
29-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com) and select your account.
30-
2. Go to **Workers & Pages**.
31-
3. Select the Worker you want to connect to a repository.
32-
4. Select **Settings** and then **Builds**.
33-
5. Select **Connect** and follow the prompts to connect the repository to your Worker and configure your [build settings](/workers/ci-cd/builds/configuration/).
34-
6. Push a commit to your Git repository to trigger a build and deploy to your Worker.
32+
1. In the Cloudflare dashboard, go to the **Workers & Pages** page.
33+
34+
<DashButton url="/?to=/:account/workers-and-pages" />
35+
36+
2. Select the Worker you want to connect to a repository.
37+
3. Select **Settings** and then **Builds**.
38+
4. Select **Connect** and follow the prompts to connect the repository to your Worker and configure your [build settings](/workers/ci-cd/builds/configuration/).
39+
5. Push a commit to your Git repository to trigger a build and deploy to your Worker.
3540

3641
:::caution
3742

@@ -54,9 +59,11 @@ If a build succeeds, it is uploaded as a version. If the build is configured to
5459
## Disconnecting builds
5560

5661
To disconnect a Worker from a GitHub or GitLab repository:
57-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com) and select your account.
58-
2. Go to **Workers & Pages**.
59-
3. Select the Worker you want to disconnect from a repository.
62+
1. In the Cloudflare dashboard, go to the **Workers & Pages** page.
63+
64+
<DashButton url="/?to=/:account/workers-and-pages" />
65+
66+
2. Select the Worker you want to disconnect from a repository.
6067
4. Select **Settings** and then **Builds**.
6168
5. Select **Disconnect**.
6269

src/content/docs/workers/ci-cd/external-cicd/gitlab-cicd.mdx

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ pcx_content_type: how-to
33
title: GitLab CI/CD
44
description: Integrate Workers development into your existing GitLab Pipelines workflows.
55
---
6+
import { DashButton } from "~/components";
67

78
You can deploy Workers with [GitLab CI/CD](https://docs.gitlab.com/ee/ci/pipelines/index.html). Here is how you can set up your GitHub Actions workflow.
89

@@ -18,11 +19,13 @@ To find your Cloudflare account ID, refer to [Find account and zone IDs](/fundam
1819

1920
To create an API token to authenticate Wrangler in your CI job:
2021

21-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com).
22-
2. Select **My Profile** > **API Tokens**.
23-
3. Select **Create Token** > find **Edit Cloudflare Workers** > select **Use Template**.
24-
4. Customize your token name.
25-
5. Scope your token.
22+
1. In the Cloudflare dashboard, go to the **Account API tokens** page.
23+
24+
<DashButton url="/?to=/:account/api-tokens" />
25+
26+
2. Select **Create Token** > find **Edit Cloudflare Workers** > select **Use Template**.
27+
3. Customize your token name.
28+
4. Scope your token.
2629

2730
You will need to choose the account and zone resources that the generated API token will have access to. We recommend scoping these down as much as possible to limit the access of your token. For example, if you have access to three different Cloudflare accounts, you should restrict the generated API token to only the account on which you will be deploying a Worker.
2831

src/content/docs/workers/configuration/integrations/momento.mdx

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ pcx_content_type: configuration
33
title: Momento
44

55
---
6+
import { DashButton } from "~/components";
67

78
[Momento](https://gomomento.com/) is a truly serverless caching service. It automatically optimizes, scales, and manages your cache for you.
89

@@ -18,14 +19,16 @@ To set up an integration with Momento Cache:
1819

1920
3. Add the Momento database integration to your Worker:
2021

21-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com) and select your account.
22-
2. In **Account Home**, select **Workers & Pages**.
23-
3. In **Overview**, select your Worker.
24-
4. Select **Integrations** > **Momento**.
25-
5. Follow the setup flow, review and grant permissions needed to add secrets to your Worker.
26-
6. Next, connect to Momento.
27-
7. Select a preferred region.
28-
8. Click **Add integration**.
22+
1. In the Cloudflare dashboard, go to the **Workers & Pages** page.
23+
24+
<DashButton url="/?to=/:account/workers-and-pages" />
25+
26+
2. In **Overview**, select your Worker.
27+
3. Select **Integrations** > **Momento**.
28+
4. Follow the setup flow, review and grant permissions needed to add secrets to your Worker.
29+
5. Next, connect to Momento.
30+
6. Select a preferred region.
31+
7. Click **Add integration**.
2932

3033
4. The following example code show how to set an item in your cache, get it, and return it as a JSON object. The credentials needed to connect to Momento Cache have been automatically added as [secrets](/workers/configuration/secrets/) to your Worker through the integration.
3134

src/content/docs/workers/configuration/previews.mdx

Lines changed: 16 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ sidebar:
88
description: Preview URLs allow you to preview new versions of your project without deploying it to production.
99
---
1010

11-
import { Render, WranglerConfig } from "~/components";
11+
import { Render, WranglerConfig, DashButton } from "~/components";
1212

1313
# Overview
1414

@@ -57,7 +57,11 @@ The [`wrangler versions upload`](/workers/wrangler/commands/#upload) command upl
5757

5858
#### View versioned preview URLs on the Workers dashboard
5959

60-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/?to=/:account/workers) and select your project.
60+
1. In the Cloudflare dashboard, go to the **Workers & Pages** page.
61+
62+
<DashButton url="/?to=/:account/workers-and-pages" />
63+
64+
2. Select your Worker.
6165
2. Go to the **Deployments** tab, and find the version you would like to view.
6266

6367
### Aliased preview URLs
@@ -93,12 +97,13 @@ The resulting alias would be associated with this version, and immediately avail
9397
When enabled, all preview URLs are available publicly. You can use [Cloudflare Access](/cloudflare-one/policies/access/) to require visitors to authenticate before accessing preview URLs. You can limit access to yourself, your teammates, your organization, or anyone else you specify in your [access policy](/cloudflare-one/policies/access).
9498

9599
To limit your preview URLs to authorized emails only:
100+
1. In the Cloudflare dashboard, go to the **Workers & Pages** page.
96101

97-
1. Log in to the [Cloudflare Access dashboard](https://one.dash.cloudflare.com/?to=/:account/access/apps).
98-
2. Select your account.
99-
3. Add an application.
100-
4. Select **Self Hosted**.
101-
5. Name your application (for example, "my-worker") and add your `workers.dev` subdomain as the **Application domain**.
102+
<DashButton url="/?to=/:account/workers-and-pages" />
103+
104+
2. Select **Create application**.
105+
3. Select **Self Hosted**.
106+
4. Name your application (for example, "my-worker") and add your `workers.dev` subdomain as the **Application domain**.
102107

103108
For example, if you want to secure preview URLs for a Worker running on `my-worker.my-subdomain.workers.dev`.
104109

@@ -126,9 +131,11 @@ Note:
126131
### From the Dashboard
127132

128133
To toggle Preview URLs for a Worker:
134+
1. In the Cloudflare dashboard, go to the **Workers & Pages** page.
135+
136+
<DashButton url="/?to=/:account/workers-and-pages" />
129137

130-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com) and select your account.
131-
2. Go to **Workers & Pages** and in **Overview**, select your Worker.
138+
2. In **Overview**, select your Worker.
132139
3. Go to **Settings** > **Domains & Routes**.
133140
4. For Preview URLs, click **Enable** or **Disable**.
134141
5. Confirm your action.

src/content/docs/workers/configuration/routing/workers-dev.mdx

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ pcx_content_type: concept
33
title: workers.dev
44
---
55

6-
import { WranglerConfig } from "~/components";
6+
import { WranglerConfig, DashButton } from "~/components";
77

88
Cloudflare Workers accounts come with a `workers.dev` subdomain that is configurable in the Cloudflare dashboard. Your `workers.dev` subdomain allows you getting started quickly by deploying Workers without first onboarding your custom domain to Cloudflare.
99

@@ -13,9 +13,11 @@ It's recommended to run production Workers on a [Workers route or custom domain]
1313

1414
`workers.dev` subdomains take the format: `<YOUR_ACCOUNT_SUBDOMAIN>.workers.dev`. To change your `workers.dev` subdomain:
1515

16-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com) and select your account.
17-
2. Select **Workers & Pages**.
18-
3. Select **Change** next to **Your subdomain**.
16+
1. In the Cloudflare dashboard, go to the **Workers & Pages** page.
17+
18+
<DashButton url="/?to=/:account/workers-and-pages" />
19+
20+
2. Select **Change** next to **Your subdomain**.
1921

2022
All Workers are assigned a `workers.dev` route when they are created or renamed following the syntax `<YOUR_WORKER_NAME>.<YOUR_SUBDOMAIN>.workers.dev`. The [`name`](/workers/wrangler/configuration/#inheritable-keys) field in your Worker configuration is used as the subdomain for the deployed Worker.
2123

@@ -25,8 +27,11 @@ All Workers are assigned a `workers.dev` route when they are created or renamed
2527

2628
To disable the `workers.dev` route for a Worker:
2729

28-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com) and select your account.
29-
2. Go to **Workers & Pages** and in **Overview**, select your Worker.
30+
1. In the Cloudflare dashboard, go to the **Workers & Pages** page.
31+
32+
<DashButton url="/?to=/:account/workers-and-pages" />
33+
34+
2. In **Overview**, select your Worker.
3035
3. Go to **Settings** > **Domains & Routes**.
3136
4. On `workers.dev` click "Disable".
3237
5. Confirm you want to disable.

src/content/docs/workers/configuration/secrets.mdx

Lines changed: 18 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ head: []
55
description: Store sensitive information, like API keys and auth tokens, in your Worker.
66
---
77

8-
import { Render } from "~/components";
8+
import { Render,DashButton } from "~/components";
99

1010
## Background
1111

@@ -66,14 +66,15 @@ npx wrangler versions secret put <KEY>
6666
#### Via the dashboard
6767

6868
To add a secret via the dashboard:
69+
1. In the Cloudflare dashboard, go to the **Workers & Pages** page.
6970

70-
1. Log in to [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account.
71-
2. Select **Workers & Pages**.
72-
3. In **Overview**, select your Worker > **Settings**.
73-
4. Under **Variables and Secrets**, select **Add**.
74-
5. Select the type **Secret**, input a **Variable name**, and input its **Value**. This secret will be made available to your Worker but the value will be hidden in Wrangler and the dashboard.
75-
6. (Optional) To add more secrets, select **Add variable**.
76-
7. Select **Deploy** to implement your changes.
71+
<DashButton url="/?to=/:account/workers-and-pages" />
72+
73+
2. In **Overview**, select your Worker > **Settings**.
74+
3. Under **Variables and Secrets**, select **Add**.
75+
4. Select the type **Secret**, input a **Variable name**, and input its **Value**. This secret will be made available to your Worker but the value will be hidden in Wrangler and the dashboard.
76+
5. (Optional) To add more secrets, select **Add variable**.
77+
6. Select **Deploy** to implement your changes.
7778

7879
### Delete secrets from your project
7980

@@ -97,13 +98,15 @@ npx wrangler versions secret delete <KEY>
9798

9899
To delete a secret from your Worker project via the dashboard:
99100

100-
1. Log in to [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account.
101-
2. Select **Workers & Pages**.
102-
3. In **Overview**, select your Worker > **Settings**.
103-
4. Under **Variables and Secrets**, select **Edit**.
104-
5. In the **Edit** drawer, select **X** next to the secret you want to delete.
105-
6. Select **Deploy** to implement your changes.
106-
7. (Optional) Instead of using the edit drawer, you can click the delete icon next to the secret.
101+
1. In the Cloudflare dashboard, go to the **Workers & Pages** page.
102+
103+
<DashButton url="/?to=/:account/workers-and-pages" />
104+
105+
2. In **Overview**, select your Worker > **Settings**.
106+
3. Under **Variables and Secrets**, select **Edit**.
107+
4. In the **Edit** drawer, select **X** next to the secret you want to delete.
108+
5. Select **Deploy** to implement your changes.
109+
6. (Optional) Instead of using the edit drawer, you can click the delete icon next to the secret.
107110

108111
<Render file="env_and_secrets" product="workers" />
109112

src/content/docs/workers/configuration/smart-placement.mdx

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ sidebar:
99
text: Beta
1010
---
1111

12-
import { WranglerConfig } from "~/components";
12+
import { WranglerConfig, DashButton } from "~/components";
1313

1414
By default, [Workers](/workers/) and [Pages Functions](/pages/functions/) are invoked in a data center closest to where the request was received. If you are running back-end logic in a Worker, it may be more performant to run that Worker closer to your back-end infrastructure rather than the end user. Smart Placement automatically places your workloads in an optimal location that minimizes latency and speeds up your applications.
1515

@@ -64,13 +64,15 @@ To enable Smart Placement via Wrangler:
6464

6565
To enable Smart Placement via the dashboard:
6666

67-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com) and select your account.
68-
2. In **Account Home**, select **Workers & Pages**.
69-
3. In **Overview**,select your Worker.
70-
4. Select **Settings** > **General**.
71-
5. Under **Placement**, choose **Smart**.
72-
6. Wait for Smart Placement to analyze your Worker. Smart Placement requires consistent traffic to the Worker from multiple locations around the world to make a placement decision. The analysis process may take up to 15 minutes.
73-
7. View your Worker's [request duration analytics](/workers/observability/metrics-and-analytics/#request-duration)
67+
1. In the Cloudflare dashboard, go to the **Workers & Pages** page.
68+
69+
<DashButton url="/?to=/:account/workers-and-pages" />
70+
71+
2. In **Overview**,select your Worker.
72+
3. Select **Settings** > **General**.
73+
4. Under **Placement**, choose **Smart**.
74+
5. Wait for Smart Placement to analyze your Worker. Smart Placement requires consistent traffic to the Worker from multiple locations around the world to make a placement decision. The analysis process may take up to 15 minutes.
75+
6. View your Worker's [request duration analytics](/workers/observability/metrics-and-analytics/#request-duration)
7476

7577
## Observability
7678

src/content/docs/workers/configuration/versions-and-deployments/rollbacks.mdx

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@ title: Rollbacks
44
head: []
55
description: Revert to an older version of your Worker.
66
---
7+
import { DashButton } from "~/components";
78

89
You can roll back to a previously deployed [version](/workers/configuration/versions-and-deployments/#versions) of your Worker using [Wrangler](/workers/wrangler/commands/#rollback) or the Cloudflare dashboard. Rolling back to a previous version of your Worker will immediately create a new [deployment](/workers/configuration/versions-and-deployments/#deployments) with the version specified and become the active deployment across all your deployed routes and domains.
910

@@ -14,9 +15,11 @@ To roll back to a specified version of your Worker via Wrangler, use the [`wrang
1415
## Via the Cloudflare Dashboard
1516

1617
To roll back to a specified version of your Worker via the Cloudflare dashboard:
18+
1. In the Cloudflare dashboard, go to the **Workers & Pages** page.
1719

18-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/?to=/:account/workers) and select your account.
19-
2. Go to **Workers & Pages** > select your Worker > **Deployments**.
20+
<DashButton url="/?to=/:account/workers-and-pages" />
21+
22+
2. Select your Worker > **Deployments**.
2023
3. Select the three dot icon on the right of the version you would like to roll back to and select **Rollback**.
2124

2225
:::caution

src/content/docs/workers/observability/errors.mdx

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ head: []
55
description: Review Workers errors and exceptions.
66
---
77

8-
import { TabItem, Tabs } from "~/components";
8+
import { TabItem, Tabs, DashButton } from "~/components";
99

1010
Review Workers errors and exceptions.
1111

@@ -230,10 +230,11 @@ Runtime errors will occur within the runtime, do not throw up an error page, and
230230
## Identify errors: Workers Metrics
231231

232232
To review whether your application is experiencing any downtime or returning any errors:
233+
1. In the Cloudflare dashboard, go to the **Workers & Pages** page.
233234

234-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com) and select your account.
235-
2. In **Account Home**, select **Workers & Pages**.
236-
3. In **Overview**, select your Worker and review your Worker's metrics.
235+
<DashButton url="/?to=/:account/workers-and-pages" />
236+
237+
2. In **Overview**, select your Worker and review your Worker's metrics.
237238

238239
### Worker Errors
239240

0 commit comments

Comments
 (0)