Skip to content

docs(cloud): add Cloud Connection Guide#458

Open
gkorland wants to merge 6 commits into
mainfrom
docs/add-cloud-connection-guide
Open

docs(cloud): add Cloud Connection Guide#458
gkorland wants to merge 6 commits into
mainfrom
docs/add-cloud-connection-guide

Conversation

@gkorland
Copy link
Copy Markdown
Contributor

@gkorland gkorland commented May 2, 2026

Summary

Create a Cloud Connection Guide covering how to obtain the endpoint, configure TLS, and connect via each supported client library.

Changes

  • New page: cloud/connecting.md with:
    • How to obtain connection details from the Cloud dashboard
    • Connection examples for Python, Node.js, Java, Rust, Go, and redis-cli
    • TLS configuration for paid tiers vs Free tier
    • Bolt protocol connection info
    • Troubleshooting table for common connection issues
  • cloud/index.md: Added link to the new connection guide

Testing

  • Front matter follows Cloud section conventions (parent: "Cloud DBaaS")
  • All internal link targets verified

Memory / Performance Impact

N/A — documentation only

Related Issues

Addresses audit item P2.7 (Audit-Report.md)

Summary by CodeRabbit

  • Documentation
    • Added a comprehensive Cloud connection guide with step‑by‑step setup, client library examples, connection options, and troubleshooting for common issues.
    • Updated the Cloud docs index to include and link to the new connection guide.

Review Change Stack

Create cloud/connecting.md with step-by-step instructions for
connecting to FalkorDB Cloud using:
- Python, Node.js, Java, Rust, Go, and redis-cli
- TLS connection details for paid tiers
- Bolt protocol connection info
- Troubleshooting table for common connection issues

Also links the new page from cloud/index.md.

Addresses audit item P2.7.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 2, 2026

Warning

Review limit reached

@Copilot, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 56 minutes and 4 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 15f79b12-4a77-429d-9772-7886ad4e8469

📥 Commits

Reviewing files that changed from the base of the PR and between 1a98ac9 and 884c751.

📒 Files selected for processing (1)
  • cloud/index.md
📝 Walkthrough

Walkthrough

Adds a new FalkorDB Cloud connection guide with steps to obtain instance details, TLS tier rules, multi-language connection examples, Bolt protocol info, troubleshooting, and a link from the cloud index.

Changes

FalkorDB Cloud Connection Guide

Layer / File(s) Summary
Connection Guide Introduction and Client Examples
cloud/connecting.md
Guide frontmatter and "Obtain Your Connection Details" explain host/port/credentials and TLS vs Free-tier; provides working examples for Python, Node.js, Java, Rust, Go, and redis-cli (TLS and Free-tier variants).
Bolt Protocol, Troubleshooting, and Related Resources
cloud/connecting.md
Bolt Protocol section documents bolt://<host>:7687 and tooling compatibility; troubleshooting table covers connection refused, SSL/TLS errors, authentication failures, and timeouts; Related Pages links to client libraries, getting started, cloud overview, and bolt support.
Cloud Index Navigation Link
cloud/index.md
Adds a "Connecting to FalkorDB Cloud" section in the cloud index that links to the new connection guide.

🎯 2 (Simple) | ⏱️ ~10 minutes

🐰
A little guide hopped into the wood,
With Python, Node, and Java all good,
TLS and Free-tier paths in sight,
Bolt on 7687 roars at night,
Now connections find their way — delight!

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'docs(cloud): add Cloud Connection Guide' directly and clearly summarizes the main change: a new documentation page (Cloud Connection Guide) added to the cloud section.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/add-cloud-connection-guide

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds a new Cloud Connection Guide to the Cloud DBaaS docs to help users retrieve their endpoint details and connect from common clients, and links it from the Cloud landing page.

Changes:

  • Added cloud/connecting.md with connection instructions/examples across multiple languages and redis-cli, plus TLS and Bolt notes.
  • Updated cloud/index.md to link to the new connection guide.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

File Description
cloud/index.md Adds a new “Connecting to FalkorDB Cloud” section linking to the new guide.
cloud/connecting.md New step-by-step connection guide including TLS tier notes, client examples, Bolt info, and troubleshooting.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread cloud/connecting.md Outdated
Comment thread cloud/connecting.md
Comment on lines +22 to +26
Your connection URL follows this format:

```
falkordb://<username>:<password>@<host>:<port>
```
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.

Fixed in 1a98ac9 by updating the documented connection URL format to falkor[s]://<username>:<password>@<host>:<port> in cloud/connecting.md.

Comment thread cloud/connecting.md Outdated
Comment thread cloud/connecting.md Outdated
gkorland and others added 2 commits May 28, 2026 09:32
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@gkorland
Copy link
Copy Markdown
Contributor Author

@copilot resolve the merge conflicts in this pull request

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@cloud/connecting.md`:
- Around line 202-204: The fenced code block containing
"bolt://my-instance.falkordb.cloud:7687" is missing a language specifier; update
the block in cloud/connecting.md to include a language (e.g., use ```text or
```none) so the fence becomes ```text followed by the URL and closing ```,
satisfying markdownlint MD040.
- Around line 24-26: The fenced code block containing the connection URI
"falkordb://<username>:<password>@<host>:<port>" is missing a language
specifier; update the triple-backtick fence to include a language (e.g., use
```text or ```bash) so the block complies with markdownlint MD040 and enables
proper syntax highlighting for the URI example.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 99b22481-19da-4bf8-ae05-48f39217ed62

📥 Commits

Reviewing files that changed from the base of the PR and between f8fb86a and 32e6f21.

📒 Files selected for processing (2)
  • cloud/connecting.md
  • cloud/index.md

Comment thread cloud/connecting.md
Comment thread cloud/connecting.md
Comment on lines +202 to +204
```
bolt://my-instance.falkordb.cloud:7687
```
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.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add language specifier to code block.

The fenced code block should specify a language for proper syntax highlighting and markdown compliance.

📝 Proposed fix
-```
+```text
 bolt://my-instance.falkordb.cloud:7687
</details>

As per coding guidelines, fenced code blocks should have a language specified (markdownlint MD040).

<!-- suggestion_start -->

<details>
<summary>📝 Committable suggestion</summary>

> ‼️ **IMPORTANT**
> Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

```suggestion

🧰 Tools
🪛 markdownlint-cli2 (0.22.1)

[warning] 202-202: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@cloud/connecting.md` around lines 202 - 204, The fenced code block containing
"bolt://my-instance.falkordb.cloud:7687" is missing a language specifier; update
the block in cloud/connecting.md to include a language (e.g., use ```text or
```none) so the fence becomes ```text followed by the URL and closing ```,
satisfying markdownlint MD040.

Copy link
Copy Markdown
Contributor

Copilot AI commented May 28, 2026

@copilot resolve the merge conflicts in this pull request

Resolved. I merged origin/main into this branch and fixed the conflict in cloud/index.md in commit 884c751.

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