Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: document application proxy #3471

Merged
merged 28 commits into from
Aug 2, 2024
Merged

docs: document application proxy #3471

merged 28 commits into from
Aug 2, 2024

Conversation

lennessyy
Copy link
Contributor

@lennessyy lennessyy commented Jul 25, 2024

Describe the Change

This PR documents how to configure applications to use proxy settings in a cluster.

Changed Pages

💻 Configure Applications to Use Proxy Server

Jira Tickets

🎫 Jira Ticket

Backports

Can this PR be backported?

  • Yes.

@lennessyy lennessyy added backport-version-4-0 Backport change to version 4.0 auto-backport Enable backport backport-version-3-4 Backport change to version 3.4 backport-version-4-1 Backport change to version 4.1 backport-version-4-2 Backport change to version 4.2 backport-version-4-3 Backport change to version 4.3 backport-version-4-4 Backport change to version 4.4 labels Jul 25, 2024
@lennessyy lennessyy marked this pull request as ready for review July 25, 2024 23:47
@lennessyy lennessyy requested a review from a team as a code owner July 25, 2024 23:47
Copy link

netlify bot commented Jul 25, 2024

Deploy Preview for docs-spectrocloud failed. Why did it fail? →

Name Link
🔨 Latest commit 6798e38
🔍 Latest deploy log https://app.netlify.com/sites/docs-spectrocloud/deploys/66a2e3f1e47d580008354cc1


If you are provisioning the PCG using the Palette CLI, you can configure the proxy settings during the PCG
installation through the Palette CLI's interactive prompts. If you are using Helm to provision a PCG or have an
existing PCG that is not yet configured to use proxy, refer to to
Copy link
Contributor

Choose a reason for hiding this comment

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

🚫 [vale] reported by reviewdog 🐶
[Vale.Repetition] 'to' is repeated!

`your-namespace` with the namespace where the pod resides.

```
kubectl get pod pod-name -o jsonpath='{.spec.containers[*].env}' --namespace your-namespace | jq .
Copy link
Contributor

Choose a reason for hiding this comment

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

🚫 [vale] reported by reviewdog 🐶
[spectrocloud-docs-internal.longform] Avoid using the short form of commands. Replace the short form flag in 'name -o' with the corresponding long form flag.

Copy link

netlify bot commented Jul 25, 2024

Deploy Preview for docs-spectrocloud ready!

Name Link
🔨 Latest commit eba72ed
🔍 Latest deploy log https://app.netlify.com/sites/docs-spectrocloud/deploys/66ad0444c3d998000802ba8d
😎 Deploy Preview https://deploy-preview-3471--docs-spectrocloud.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.


If you are provisioning the PCG using the Palette CLI, you can configure the proxy settings during the PCG
installation through the Palette CLI's interactive prompts. If you are using Helm to provision a PCG or have an
existing PCG that is not yet configured to use proxy, refer to to
Copy link
Contributor

Choose a reason for hiding this comment

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

🚫 [vale] reported by reviewdog 🐶
[Vale.Repetition] 'to' is repeated!

`your-namespace` with the namespace where the pod resides.

```
kubectl get pod pod-name -o jsonpath='{.spec.containers[*].env}' --namespace your-namespace | jq .
Copy link
Contributor

Choose a reason for hiding this comment

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

🚫 [vale] reported by reviewdog 🐶
[spectrocloud-docs-internal.longform] Avoid using the short form of commands. Replace the short form flag in 'name -o' with the corresponding long form flag.

@lennessyy lennessyy removed backport-version-4-0 Backport change to version 4.0 backport-version-3-4 Backport change to version 3.4 backport-version-4-1 Backport change to version 4.1 backport-version-4-2 Backport change to version 4.2 backport-version-4-3 Backport change to version 4.3 labels Jul 29, 2024
Copy link
Contributor

@karl-cardenas-coding karl-cardenas-coding left a comment

Choose a reason for hiding this comment

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

Great writeup @lennessyy . Some suggestions and comments below.

[Enable and Manage Proxy Configurations for PCG](../pcg/manage-pcg/configure-proxy.md) to learn how to install Reach
on a PCG cluster and use it to configure proxy settings.

2. Once you have configured proxy settings through Reach for your PCG, you can proceed to create your cluster using a
Copy link
Contributor

Choose a reason for hiding this comment

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

SaaS customers will have to register a new cloud account in Palette and specify the PCG. They cannot alter existing cloud accounts. I think it would help if we link to the three public cloud accounts registration guides to help the user.


<TabItem value="Palette SaaS Non-Edge">

1. If you are using Palette SaaS, you must deploy a Private Cloud Gateway (PCG) and configure it to use a proxy server
Copy link
Contributor

Choose a reason for hiding this comment

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

🚫 [vale] reported by reviewdog 🐶
[Vale.Terms] Use 'cloud' instead of 'Cloud'.


1. If you are using Palette SaaS, you must deploy a Private Cloud Gateway (PCG) and configure it to use a proxy server
before you can configure cluster applications to use the proxy server. For more information about PCGs, refer to
[Private Cloud Gateway](../pcg/pcg.md). You must configure proxy settings for the PCG, and then clusters created by
Copy link
Contributor

Choose a reason for hiding this comment

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

🚫 [vale] reported by reviewdog 🐶
[Vale.Terms] Use 'cloud' instead of 'Cloud'.

@lennessyy lennessyy enabled auto-merge (squash) August 2, 2024 16:07
@lennessyy lennessyy merged commit 6b429f2 into master Aug 2, 2024
15 checks passed
@lennessyy lennessyy deleted the cluster-proxy branch August 2, 2024 16:18
vault-token-factory-spectrocloud bot pushed a commit that referenced this pull request Aug 2, 2024
* docs: initial commit

* docs: progress

* docs: progress

* docs: incomplete

* docs: draft proxy settings

* docs: finish draft of cluster proxy settings

* docs: copy edits

* docs: add prerequisite sections

* docs: add prerequisites

* docs: fix syntax issue

* docs: fix syntax issue

* docs: syntax issue

* docs: fix broken links

* docs: minor edit

* docs: adjust list order

* docs: address vale

* docs: use group ID

* docs: change code highlight

* docs: address review feedback

* docs: minor edit

* docs: fix typo

* docs: change link

---------

Co-authored-by: Lenny Chen <[email protected]>
Co-authored-by: Karl Cardenas <[email protected]>
(cherry picked from commit 6b429f2)
@vault-token-factory-spectrocloud
Copy link
Contributor

💚 All backports created successfully

Status Branch Result
version-4-4

Note: Successful backport PRs will be merged automatically after passing CI.

Questions ?

Please refer to the Backport tool documentation and see the Github Action logs for details

vault-token-factory-spectrocloud bot added a commit that referenced this pull request Aug 2, 2024
* docs: initial commit

* docs: progress

* docs: progress

* docs: incomplete

* docs: draft proxy settings

* docs: finish draft of cluster proxy settings

* docs: copy edits

* docs: add prerequisite sections

* docs: add prerequisites

* docs: fix syntax issue

* docs: fix syntax issue

* docs: syntax issue

* docs: fix broken links

* docs: minor edit

* docs: adjust list order

* docs: address vale

* docs: use group ID

* docs: change code highlight

* docs: address review feedback

* docs: minor edit

* docs: fix typo

* docs: change link

---------

Co-authored-by: Lenny Chen <[email protected]>
Co-authored-by: Karl Cardenas <[email protected]>
(cherry picked from commit 6b429f2)

Co-authored-by: Lenny Chen <[email protected]>
@vault-token-factory-spectrocloud
Copy link
Contributor

🎉 This PR is included in version 4.4.12 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
auto-backport Enable backport backport-version-4-4 Backport change to version 4.4 released
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants