Skip to content

Conversation

@paigecalvert
Copy link
Contributor

No description provided.

@replicated-ci replicated-ci added type::docs Improvements or additions to documentation type::feature labels Dec 12, 2024
@netlify
Copy link

netlify bot commented Dec 12, 2024

Deploy Preview for replicated-docs ready!

Name Link
🔨 Latest commit 0b8e0d5
🔍 Latest deploy log https://app.netlify.com/sites/replicated-docs/deploys/675b35f0fa91710008dfab1d
😎 Deploy Preview https://deploy-preview-2900--replicated-docs.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.

@netlify
Copy link

netlify bot commented Dec 12, 2024

Deploy Preview for replicated-docs-upgrade ready!

Name Link
🔨 Latest commit 0b8e0d5
🔍 Latest deploy log https://app.netlify.com/sites/replicated-docs-upgrade/deploys/675b35f04414cd0008766b62
😎 Deploy Preview https://deploy-preview-2900--replicated-docs-upgrade.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.


<IntegrationMode/>

## Port Forwarding the SDK API Service {#port-forward}
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Moved the port forwarding procedure to its own section of "Developing Against the SDK API".

Originally, I had this as just the last two steps in the integration mode procedure, but then I wasn't sure if maybe people would want to know how to do this outside of integration mode & also if it might be helpful to have a direct anchor link to the port forwarding steps that we could send to people

This topic describes the methods for distributing and installing the Replicated SDK.

It includes information about how to install the SDK alongside Helm chart- or standard manifest-based applications using the Helm CLI or Replicated KOTS. It also includes information about installing the SDK separately from an application as a standalone component in integration mode.
It includes information about how to install the SDK alongside Helm charts or Kubernetes manifest-based applications using the Helm CLI or a Replicated installer (Replicated KOTS, kURL, Embedded Cluster). It also includes information about installing the SDK as a standalone component in integration mode.
Copy link
Contributor Author

@paigecalvert paigecalvert Dec 12, 2024

Choose a reason for hiding this comment

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

^ Updating some dated language. Removing "standard" manifest in favor or k8s manifest. Also, the "Replicated installer" thing is the current way to talk about kots, kurl, ec

You can use the Replicated SDK in integration mode to develop locally against the SDK API without needing to add the SDK to your application, create a release in the Replicated Vendor Portal, or make changes in your environment. You can also use integration mode to test sending instance data to the Vendor Portal, including any custom metrics that you configure.
To use integration mode, install the Replicated SDK as a standalone component using a valid development license. For more information, see [Developing Against the SDK API](/vendor/replicated-sdk-development).
<IntegrationMode/>
Copy link
Contributor Author

Choose a reason for hiding this comment

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

^ put the partial here so that people could see the steps rather than having to click away

'vendor/replicated-sdk-overview',
'vendor/replicated-sdk-installing',
'vendor/replicated-sdk-airgap',
'vendor/replicated-sdk-development',
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Moved this up to main SDK section


To use integration mode, install the Replicated SDK as a standalone component using a valid Development license created in the Vendor Portal. After you install in integration mode, the SDK provides default mock data for requests to the SDK API `app` endpoints. Requests to the `license` endpoints use the real data from your Development license.

To install the SDK in integration mode:
Copy link
Contributor Author

Choose a reason for hiding this comment

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

made these steps a partial so they could be included in both the Developing Against the SDK API and the Installing the SDK topics. Both seemed reasonable places to look for this info

@paigecalvert paigecalvert marked this pull request as ready for review December 12, 2024 19:19
@paigecalvert paigecalvert requested a review from a team as a code owner December 12, 2024 19:19
@ajp-io ajp-io merged commit 9a8e659 into main Dec 16, 2024
5 checks passed
@ajp-io ajp-io deleted the 117132 branch December 16, 2024 16:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type::docs Improvements or additions to documentation type::feature

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants