Skip to content

[Teams] Tunnel guides + Gateway tutorial#2114

Merged
abracchi-tw merged 6 commits into
productionfrom
docs-fixes
Aug 20, 2021
Merged

[Teams] Tunnel guides + Gateway tutorial#2114
abracchi-tw merged 6 commits into
productionfrom
docs-fixes

Conversation

@abracchi-tw

Copy link
Copy Markdown
Contributor

No description provided.

@abracchi-tw
abracchi-tw requested a review from a team August 19, 2021 18:26
pcx-content-type: reference
---

# Install `cloudflared`

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@abelinkinbio @sudarshan-reddy the idea is to make this a download page, and move everything re: installation to its own Tunnel guide, one for each OS. wdyt?

@sudarshan-reddy sudarshan-reddy Aug 19, 2021

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a good idea! I think this page is a bit cluttered and this will help. However, maybe we can do something like a modal for each OS only when the instructions diverge keeping the rest common? (For example, I love what Go does here: https://golang.org/doc/install)

mv /root/cloudflared/cloudflared /usr/bin/cloudflared
```

## 3. Authenticate cloudflared.

@marciocloudflare marciocloudflare Aug 20, 2021

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## 3. Authenticate cloudflared.
## 1. Authenticate cloudflared

* Open a browser window and prompt you to log into your Cloudflare account. After logging into your account, select your hostname.
* Generate a [cert.pem file](/connections/connect-apps/tunnel-useful-terms#cert-pem). The `cert.pem` file contains account-wide credentials.

## 4. Create a tunnel and give it a name.

@marciocloudflare marciocloudflare Aug 20, 2021

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## 4. Create a tunnel and give it a name.
## 1. Create a tunnel and give it a name


From the output of the command, take note of the tunnel’s UUID and the path to your tunnel’s credentials file.

## 5. Create a configuration file.

@marciocloudflare marciocloudflare Aug 20, 2021

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## 5. Create a configuration file.
## 1. Create a configuration file

credentials-file: /root/.cloudflared/6ff42ae2-765d-4adf-8112-31c55c1551ef.json
```

## 6. Start routing traffic.

@marciocloudflare marciocloudflare Aug 20, 2021

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## 6. Start routing traffic.
## 1. Start routing traffic

$ cloudflared tunnel route ip show
```

## 7. Run the tunnel.

@marciocloudflare marciocloudflare Aug 20, 2021

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## 7. Run the tunnel.
## 1. Run the tunnel


Cloudflare Tunnel can install itself as a system service on Linux and Windows and as a launch agent on macOS. For more information, see [Run as a service](/connections/connect-apps/run-tunnel/run-as-service).

## 8. Check the tunnel

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## 8. Check the tunnel
## 1. Check the tunnel

@marciocloudflare marciocloudflare Aug 20, 2021

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've just realized something: I'm not sure if changing every H2 to ## 1. will create the correct numbers automatically because you have pieces of code between each H2. If that's the case and you see that upon building your docs the numbered list is wrong, you'll have to add a tab or a couple of spaces (depends on how your VSCode is configured) on the pieces of text between each H2. This will indicate the text is a part of that H2 and number correctly your list

* Open a browser window and prompt you to log into your Cloudflare account. After logging into your account, select your hostname.
* Generate a [cert.pem file](/connections/connect-apps/tunnel-useful-terms#cert-pem). The `cert.pem` file contains account-wide credentials.

## 3. Create a tunnel and give it a name.

@marciocloudflare marciocloudflare Aug 20, 2021

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## 3. Create a tunnel and give it a name.
## 1. Create a tunnel and give it a name


</Aside>

## 1. Download `cloudflared`.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## 1. Download `cloudflared`.
## 1. Download `cloudflared`


</Aside>

## 1. Download `cloudflared`.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## 1. Download `cloudflared`.
## 1. Download `cloudflared`

mv /root/cloudflared/cloudflared /usr/bin/cloudflared
```

## 3. Authenticate `cloudflared`.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## 3. Authenticate `cloudflared`.
## 1. Authenticate `cloudflared`


From the output of the command, take note of the tunnel’s UUID and the path to your tunnel’s credentials file.

## 5. Create a configuration file.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## 5. Create a configuration file.
## 1. Create a configuration file

Comment thread products/cloudflare-one/src/content/tutorials/integrate-microsoft-mcas-teams.md Outdated
Comment thread products/cloudflare-one/src/content/tutorials/integrate-microsoft-mcas-teams.md Outdated
Comment thread products/cloudflare-one/src/content/tutorials/integrate-microsoft-mcas-teams.md Outdated
Comment thread products/cloudflare-one/src/content/tutorials/integrate-microsoft-mcas-teams.md Outdated
Comment thread products/cloudflare-one/src/content/tutorials/integrate-microsoft-mcas-teams.md Outdated
@abracchi-tw
abracchi-tw merged commit c91afce into production Aug 20, 2021
@abracchi-tw
abracchi-tw deleted the docs-fixes branch August 20, 2021 11:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants