* chore: add .worktrees to gitignore
* refactor: replace URL-parsing in shortcodes with cascade product data
Replace duplicated URL-parsing logic across 28 shortcodes with Hugo's
cascade frontmatter. Each product section's _index.md now cascades
`product` (data key) and `version` (URL segment) to all descendants.
Key changes:
- Add cascade frontmatter to 15 product _index.md files
- Create layouts/partials/product/get-data.html shared partial
- Refactor 28 shortcodes to use the partial instead of parsing URLs
- Add version_label, limits, and distributed_architecture metadata
to data/products.yml to eliminate hardcoded dicts in shortcodes
- Fix lefthook lint-markdown-instructions glob format (YAML array)
- Fix pre-existing Vale exclamation point errors in cloud and v2
* fix: prevent remark-lint from escaping Hugo template syntax in shortcodes
Lefthook's glob option only triggers whether a command runs — it does
not filter {staged_files}. This caused remark-lint to process .md
shortcode files in layouts/, escaping underscores, brackets, and
parentheses that are valid Hugo template syntax.
Add layouts/ exclusion to the existing content/ filter in the
lint-markdown-instructions run command. Also fix the 3 shortcode files
that were damaged by remark-lint in the previous commit.
* test: add E2E tests for cascade product shortcodes
Add Cypress tests validating all refactored shortcodes across 14
product/version combos (82 tests). Test expectations are derived
from products.yml at runtime via cy.task('getData').
Fix the product links test to iterate actual home page links
instead of all products.yml entries.
Create _test/shortcodes.md pages in each product section
exercising product-name, product-key, current-version,
influxdb/host, and InfluxDB3-specific shortcodes.
* test: expand E2E coverage to 27 of 28 cascade shortcodes
Add shortcode invocations to all 14 test pages and corresponding
Cypress assertions for version lookups, namespace URLs, product
name text, placeholder_host, version visibility, CTA links, and
site-level data.
Add shortcodes-real-pages.cy.js for 6 shortcodes that require real
page context (cli/mapped, children, flux/list-all-functions,
telegraf/plugins, html-diagram/sso-auth-flow, cli/influxd-flags).
Suppress Vale on test pages — they contain only shortcode syntax,
not prose.
163 tests total, all passing.
* refactor(test): rename _test dirs to __tests__ and add noindex
Rename test page directories from _test to __tests__ to align with
JS testing conventions. Add noindex: true to all 14 test page
frontmatter to prevent search engine indexing in production.
Update Cypress URL pattern to match new paths.
* base content for influxdb3 query guides
* added enterprise versions of query guides
* Apply suggestions from code review
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
* update template titles to use .RenderString
---------
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
* base changes for influxdb cloud dedicated
* removed unnecessary whitespace from dedicated homepage
* influxctl reference documentation (#4855)
* influxctl reference docs
* fixed typo, added auth0 token life span
* Apply suggestions from code review
Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
* more updates to influxctl docs
* update influxctl docs to address PR feedback
---------
Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
* Add admin and manage databases sections to Cloud Dedicated (#4857)
* add admin and manage databases sections
* Apply suggestions from code review
Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
* added missing page descriptions to admin docs
---------
Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
* Add token management documentation to Cloud Dedicated documentation (#4861)
* add manage tokens documentation to dedicated
* Apply suggestions from code review
Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
* update admin token docs to address PR feedback
---------
Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
* Dedicated get started (#4878)
* WIP dedicated get started content
* fix(cst): infinite cardinality (#4851)
* WIP cloud dedicated get started
* feat(cloud-dedicated): WIP - write data to Cloud Dedicated
* fix(cloud-dedicated): grammar.
* feat(cloud-dedicated): WIP outline write methods, v1 API use
* fix(cloud-dedicated): dupe name.
* updated staging config, fixed dedicated page titles
* updated dedicated setup doc
* Cloud Dedicated primers v1 API: auth and write (#4865)
* feat(cloud-dedicated): v1 API with Cloud Dedicated
- Add /primers >> /api >> /v1 and /v2
- Move draft started in /write-data to /primers/api/v1
- Created code samples that still need testing
- v1 authentication schemes.
* fix(cloud-dedicated): list children pages
* wip(cloud-dedicated): v1 primer intro
* wip(cloud-dedicated): auth fixes.
* feat(cloud-dedicated): v1 API primer
- part of #4863, #4864
Still untested against CST:
- v1 auth methods
- v1 /write
- Telegraf config
- Precision
- API sample code
* Update content/influxdb/cloud-dedicated/primers/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/_index.md
* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md
* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/v2/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/v2/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update layouts/shortcodes/api/cloud/v2-prefer.html
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update shared/text/api/cloud-dedicated/basic-auth.js
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
---------
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Dedicated v1 write (#4873)
* wip(v1): Revise v1 and add client library info.
* feat(cloud-dedicated): primer v1 API auth and writes
- Fixes for v1 auth and writes
- Configuring node and python v1 client libraries for Cloud Dedicated.
* fix(cloud-dedicated): v1 intros:
- Fix redundant intro
- Query intros
* Apply suggestions from code review
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
---------
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Dedicated v2 write (#4875)
* fix(cloud-dedicated): v1 API primer:
- fix typo
- fix description
* wip(cloud-dedicated): v2 auth, write, Telegraf
* feat(cloud-dedicated): v2 API primer (#4874)
- v2 authentication
- Write using /api/v2/write
- Cleanup in v1
* Update content/influxdb/cloud-dedicated/primers/api/v2/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update shared/text/api/cloud-dedicated/token-auth-v2-write.sh
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* fix(cloud-dedicated): parameters for v1 and v2 writes
- testing proves that org can't be empty
Ongoing:
- writes with v2 client library appear to work, but I can't find the measurement when I query.
- v1 writes with curl respond with 404.
---------
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Add Python and Go write instructions to Cloud Dedicated get started (#4876)
* added python and go write instructions to dedicated get started
* Add get started query guide to dedicated (#4877)
* Add get started query guide to dedicated
* Apply suggestions from code review
Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
---------
Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
* Apply suggestions from code review
Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
* Apply suggestions from code review
---------
Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
---------
Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
* Port reference content into dedicated (#4879)
* ported line protocol and sql reference
* port glossary to dedicated
* fix(cloud-dedicated): cleanup (#4880)
* fix(cloud-dedicated): v1 parameter values
- Fixes parameter values in requests.
- Based on inspection of the request (default port, content-type headers).
- Still not working in CST.
* fix(cloud-dedicated): cleanup auth description and list query tools.
* fix(cloud-dedicated): cleanup auth examples:
- remove boilerplate JS examples. Eventually replace with client lib examples.
- fix incorrect URL
- replace localhost with cloud2 host
* fix(cloud-dedicated): replace placeholders
* Add support for custom dedicated URLs (#4882)
* add support for custom dedicated urls
* Apply suggestions from code review
Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
* removed unnecessary conditional in influxdb-urls.js
---------
Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
* add information about flight sql support (#4894)
* Update influxctl install and setup instructions (#4893)
* updated influxctl install and setup instructions
* added details to influxctl init page
* Apply suggestions from code review
Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
---------
Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
* Dedicated query data (#4895)
* WIP port query data section to dedicated
* updated database-name to iox-namespace-name
* updated grafana instructions
* update grafana install instructions
* updated images and links
* fixed broken links in query data section
* fix(cloud-dedicated): get-started write (#4890)
* fix(cloud-dedicated): package name typo
* fix(cloud-dedicated): URL missing query
* fix(cloud-dedicated): iox-namespace-name
* fix(cloud-dedicated): use get-started database name
* fix(cloud-dedicated): add auth-specific examples.
* fix(cloud-dedicated): use Bearer for v2 example
* fix(cloud-dedicated): add a note about token schemes and link to primer.
* fix(cloud-dedicated): org no longer required by API, remove from curl example
* fix(cloud-dedicated): use Bearer
* fix(cloud-dedicated): wordsmithing
* fix(cloud-dedicated): file name
* fix(cloud-dedicated): Go client works without org
* fix(cloud-dedicated): separate the commands for copy-pasting
* fix(cloud-dedicated): v1 API token authentication
* fix(cloud-dedicated): org parameter ignored, but needed in python clients
* fix(cloud-dedicated): v1 API examples and params for /query (#4897)
* fix(cloud-dedicated): minor word change (#4898)
* New homepage and structural changes (#4899)
* WIP first sweep of cloud-iox to cloud-serverless
* WIP iox to serverless content updates
* WIP iox to serverless updates in page templates and data files
* WIP new homepage
* chore(dedicated): copy best-practices from serverless
* fix(serverless): missing shortcut
* new homepage
* fix(dedicated): token links in v1 API primer
* chore(dedicated): write csv with Telegraf
* fix(serverless): write CSV with Telegraf
* updated homepage styles
* updated deps, fix unclosed shortcodes, fix light css
* fix product selector order
* updated database naming restrictions, add resource delete confirmation
* add cloud-ios to cloud-serverless redirect to edge.js
* remove sh from allowed extentions
* fix bug in redirect logic
* add sections to product dropdown (#4900)
* minor homepage css adjustment
* fixed page titles
* fixed more iox references in templates
* Apply suggestions from code review
Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
* Migrate 1.x data to dedicated (#4901)
* fix(serverless): cleanup
* chore(dedicated): Migrate 1.x data to dedicated
- Minimal adaptation of IOx to Dedicated for now.
- Use APIs for writing data (CLIs? pyinflux3 only writes CSV? Can't promote influxdb_iox for now)
- Add 2.x CLI warning
* fix(dedicated): URL typos
* Update content/influxdb/cloud-dedicated/write-data/migrate-data/_index.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/write-data/migrate-data/migrate-1x-to-cloud-dedicated.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/write-data/migrate-data/migrate-1x-to-cloud-dedicated.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/write-data/migrate-data/migrate-1x-to-cloud-dedicated.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/write-data/migrate-data/migrate-1x-to-cloud-dedicated.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* Update content/influxdb/cloud-dedicated/write-data/migrate-data/migrate-1x-to-cloud-dedicated.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
---------
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
---------
Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
* add step for requesting a cluster in dedicated setup
* minor content fixes in best practices
---------
Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
* chore(refactor): refactor the SQL schema intro into a partial shortcode for reuse.
* fix(cloud-iox): #4806 Setup and query Grafana Flight SQL
- Help configuring a Homebrew installed Grafana
- Add some query help
- Add note about schema elements.
- Warn about functions not working.
- Screenshot of query builder.
* fix(cloud-iox): Grafana frontmatter
* fix(cloud-iox): Remove incorrect note about aggregate function support. Clarify required time column and the use of aggregations.
* wip: pandas.md
* wip: python.md
* chore(cloud-iox): update frontmatter for Execute queries
* feature(cloud-iox): use Python and Flight SQL to query, pandas and pyarrow to analyze:
- Adds /tools to Query Data
- Adds using Python with flightsql-dbapi to query data
- Adds starter for using PyArrow to analyze data
- Adds starter for using pandas to analyze data
* chore(cloud-iox): Move pages from Visualize data into Query Data > Tools
- Move Grafana
- Move Superset
- #4806
* Update content/influxdb/cloud-iox/query-data/tools/grafana.md
* Apply suggestions from code review
@sanderson Thanks for the review! Sorry for all the whitespace fixes.
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* fix(cloud-iox): infinite cardinality (#4851) (#4853)
* fix(cloud-iox): pyarrow examples.
* fix(cloud-iox): wip - python examples.
* fix(cloud-iox): Python flightsql-dbapi, pandas, pyarrow guides
- part of #4806
- Add list code example
- Add code comments
- Fix whitespace
- Fix description
- add related
- add steps
- fix frontmatter
- add comments
- cleanup example
* Update content/influxdb/cloud-iox/query-data/execute-queries/flight-sql/python.md
* Update content/influxdb/cloud-iox/query-data/tools/grafana.md
* fix(cloud-iox): #4806 Grafana instructions
* fix(cloud-iox): #4806 pandas instructions
---------
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
* fix(cloud-iox): Superset instruction (#4806)
* chore(docs): add example keywords for code-callout so I can find it later.
* chore(refactor): refactor the SQL schema intro into a partial shortcode for reuse.
* fix(cloud-iox): #4806 Setup and query Grafana Flight SQL
- Help configuring a Homebrew installed Grafana
- Add some query help
- Add note about schema elements.
- Warn about functions not working.
- Screenshot of query builder.
* fix(cloud-iox): superset frontmatter description (#4806)
* fix(cloud-iox): Grafana frontmatter
* fix(cloud-iox): Remove incorrect note about aggregate function support. Clarify required time column and the use of aggregations.
* Apply suggestions from code review
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
---------
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
Jason Stirnaman
Scott Anderson
Scott Anderson
Jason Stirnaman