docs: Expand deployment guide (CI/CD, GCP, read/write separation, cluster-sidecar) (#1651)
* docs: Add CI/CD deployment section with GitHub Actions guide
Adds a starter CI/CD page covering the spice-cloud-deploy-action GitHub
Action for Spice Cloud Platform deployments and pointers to the existing
Argo CD and Flux GitOps guides for self-hosted Kubernetes.
Refs #1049
* ci: trigger fresh CI run
* Add GCP integrations documentation and deployment guides
- Introduced a new document for GCP integrations detailing data connectors, AI models, embeddings, and authentication methods.
- Updated the main deployment guide to include GCP as a deployment target and outlined deployment architectures.
- Added a new guide for read/write separation to optimize data ingestion and querying workloads.
- Created a cluster-sidecar architecture document to explain the benefits and considerations of this deployment model.
- Updated snapshots documentation to reference the new read/write separation guide and clarified configuration options.
* fix: update tags in read/write separation documentation to reflect Kubernetes and Helm
* fix: update links in GCP deployment and read/write separation documentation for consistency
* fix: remove unnecessary semicolon in hybrid architecture documentation
---------
Co-authored-by: claudespice <claudespice@users.noreply.github.com>
Co-authored-by: Luke Kim <80174+lukekim@users.noreply.github.com>
2 months ago
Add cluster-sidecar hybrid architecture (#1387)
* Refactor deployment architecture documentation to use MDX components for better modularity and maintainability
- Updated microservice, sharded, sidecar, tiered, cluster, hosted, and hybrid architecture documentation to import content from MDX partials.
- Removed inline content in favor of centralized MDX files for each architecture type.
- Added new hybrid architecture documentation to support sidecar caching backed by a centralized cluster.
* Update image formatting in deployment architecture documentation for consistency
4 months ago
Add cluster-sidecar hybrid architecture (#1387)
* Refactor deployment architecture documentation to use MDX components for better modularity and maintainability
- Updated microservice, sharded, sidecar, tiered, cluster, hosted, and hybrid architecture documentation to import content from MDX partials.
- Removed inline content in favor of centralized MDX files for each architecture type.
- Added new hybrid architecture documentation to support sidecar caching backed by a centralized cluster.
* Update image formatting in deployment architecture documentation for consistency
4 months ago
docs: Expand deployment guide (CI/CD, GCP, read/write separation, cluster-sidecar) (#1651)
* docs: Add CI/CD deployment section with GitHub Actions guide
Adds a starter CI/CD page covering the spice-cloud-deploy-action GitHub
Action for Spice Cloud Platform deployments and pointers to the existing
Argo CD and Flux GitOps guides for self-hosted Kubernetes.
Refs #1049
* ci: trigger fresh CI run
* Add GCP integrations documentation and deployment guides
- Introduced a new document for GCP integrations detailing data connectors, AI models, embeddings, and authentication methods.
- Updated the main deployment guide to include GCP as a deployment target and outlined deployment architectures.
- Added a new guide for read/write separation to optimize data ingestion and querying workloads.
- Created a cluster-sidecar architecture document to explain the benefits and considerations of this deployment model.
- Updated snapshots documentation to reference the new read/write separation guide and clarified configuration options.
* fix: update tags in read/write separation documentation to reflect Kubernetes and Helm
* fix: update links in GCP deployment and read/write separation documentation for consistency
* fix: remove unnecessary semicolon in hybrid architecture documentation
---------
Co-authored-by: claudespice <claudespice@users.noreply.github.com>
Co-authored-by: Luke Kim <80174+lukekim@users.noreply.github.com>
2 months ago
Add cluster-sidecar hybrid architecture (#1387)
* Refactor deployment architecture documentation to use MDX components for better modularity and maintainability
- Updated microservice, sharded, sidecar, tiered, cluster, hosted, and hybrid architecture documentation to import content from MDX partials.
- Removed inline content in favor of centralized MDX files for each architecture type.
- Added new hybrid architecture documentation to support sidecar caching backed by a centralized cluster.
* Update image formatting in deployment architecture documentation for consistency
4 months ago
docs: Comprehensive partitioning, partition transforms, and pruning rules
Rewrite the partitioning page with full coverage of supported
partition transforms (bucket, truncate, date_part, date_trunc,
modulo), composite partitioning, pruning matrix per filter shape,
engine-specific behavior (Arrow / DuckDB files-mode / DuckDB tables-mode
/ Cayenne), validation rules, and worked examples.
Verified against the Rust source: bucket return type matches the
num_buckets literal (Int8..Int64 / UInt8..UInt64) — not always Int64
as previously documented in scalar_functions.md. Truncate accepts
Utf8 and Binary in addition to numeric types. date_part filter
pruning is not yet implemented; equality on the partition expression
still prunes correctly.
Also:
- Cross-link from data-acceleration index to the new partitioning page
- Distinguish deployment-level sharding from acceleration partitioning
in the sharded architecture page
- Correct bucket return type and truncate input type list in scalar_functions.md
2 months ago
Add cluster-sidecar hybrid architecture (#1387)
* Refactor deployment architecture documentation to use MDX components for better modularity and maintainability
- Updated microservice, sharded, sidecar, tiered, cluster, hosted, and hybrid architecture documentation to import content from MDX partials.
- Removed inline content in favor of centralized MDX files for each architecture type.
- Added new hybrid architecture documentation to support sidecar caching backed by a centralized cluster.
* Update image formatting in deployment architecture documentation for consistency
4 months ago
Add cluster-sidecar hybrid architecture (#1387)
* Refactor deployment architecture documentation to use MDX components for better modularity and maintainability
- Updated microservice, sharded, sidecar, tiered, cluster, hosted, and hybrid architecture documentation to import content from MDX partials.
- Removed inline content in favor of centralized MDX files for each architecture type.
- Added new hybrid architecture documentation to support sidecar caching backed by a centralized cluster.
* Update image formatting in deployment architecture documentation for consistency
4 months ago