Skip to content

docs(cloud): Guide for private git dependencies#590

Open
christerswahn wants to merge 1 commit into
mainfrom
ces-dev
Open

docs(cloud): Guide for private git dependencies#590
christerswahn wants to merge 1 commit into
mainfrom
ces-dev

Conversation

@christerswahn

Copy link
Copy Markdown
Contributor

No description provided.

@christerswahn christerswahn requested review from Isakdl and vlidholt June 10, 2026 07:43

@Swiftaxe Swiftaxe left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Nice update!

Added a few nit comments.


[Set up deploy keys in GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/managing-deploy-keys#set-up-deploy-keys)

Then store the private SSH key as a build secret on your Severpod Cloud project,

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Then store the private SSH key as a build secret on your Severpod Cloud project,
Then store the private SSH key as a build secret on your Serverpod Cloud project,


Use the `scloud deployment build-secret` commands to manage your build secrets.

#### List the current build secrets

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

This skips from H2 headings to H4. Consider whether to add an H3 heading above the H4 ones, or bump them to H3.


Do this by setting a _build secret_ on the project.

> Build secrets are kept separate from runtime secrets and will not be accessible

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Use a docusaurus :::info admonition here instead of a blockquote.


### SSH keys

Currently SSH keys are supported, and you store the private SSH key in the build secret.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Nit: This section is too thin. Consider whether this line belongs in the section above together with the ssh file example.

Also, "Currently" suggests something is about to change. It is better to be specific about whether we are moving away from it.

@developerjamiu developerjamiu Jun 10, 2026

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.

Suggestion (line 3, intro): the current opening frames workspaces as the only path, but the PR adds private-git-deps as a second path. Surfacing both up front helps the reader pick.

Proposed rewrite of line 3:

Serverpod Cloud handles private dependencies in two ways: as local packages in a Dart workspace, or as private git dependencies authenticated with an SSH-key build secret. Pick the one that matches how your private code is stored.

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