Skip to content

Commit a1b1705

Browse files
jstirnamanjstirnaman
authored
Merge branch 'master' into plugin_error_handling
2 parents 683c6f9 + 347cad3 commit a1b1705

File tree

38 files changed

+2246
-891
lines changed

38 files changed

+2246
-891
lines changed

‎content/influxdb/v2/install/_index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -355,9 +355,9 @@ To install {{% product-name %}} on Linux, do one of the following:
355355
echo "943666881a1b8d9b849b74caebf02d3465d6beb716510d86a39f6c8e8dac7515 influxdata-archive.key" \
356356
| sha256sum --check - && cat influxdata-archive.key \
357357
| gpg --dearmor \
358-
| tee /etc/apt/trusted.gpg.d/influxdata-archive.gpg > /dev/null \
358+
| sudo tee /etc/apt/trusted.gpg.d/influxdata-archive.gpg > /dev/null \
359359
&& echo 'deb [signed-by=/etc/apt/trusted.gpg.d/influxdata-archive.gpg] https://repos.influxdata.com/debian stable main' \
360-
| tee /etc/apt/sources.list.d/influxdata.list
360+
| sudo tee /etc/apt/sources.list.d/influxdata.list
361361
# Install influxdb
362362
sudo apt-get update && sudo apt-get install influxdb2
363363
```

‎content/influxdb3/cloud-dedicated/reference/sql/functions/binary-string.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
title: SQL binary string functions
3+
list_title: Binary string functions
4+
description: >
5+
Use binary string functions to encode and decode binary string values in
6+
SQL queries.
7+
menu:
8+
influxdb3_cloud_dedicated:
9+
name: Binary string
10+
parent: sql-functions
11+
weight: 308
12+
13+
source: /content/shared/sql-reference/functions/binary-string.md
14+
---
15+
16+
<!--
17+
The content of this page is at
18+
// SOURCE /content/shared/sql-reference/functions/binary-string.md
19+
-->

‎content/influxdb3/cloud-dedicated/reference/sql/functions/hashing.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
title: SQL hashing functions
3+
list_title: Hashing functions
4+
description: >
5+
Use hashing functions to hash string values in SQL queries using established
6+
hashing algorithms.
7+
menu:
8+
influxdb3_cloud_dedicated:
9+
name: Hashing
10+
parent: sql-functions
11+
weight: 309
12+
13+
source: /shared/sql-reference/functions/hashing.md
14+
---
15+
16+
<!--
17+
The content for this page is at
18+
// SOURCE /content/shared/sql-reference/functions/hashing.md
19+
-->

‎content/influxdb3/cloud-dedicated/reference/sql/operators/comparison.md

Lines changed: 15 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -10,19 +10,21 @@ menu:
1010
parent: Operators
1111
weight: 302
1212
list_code_example: |
13-
| Operator | Meaning | Example |
14-
| :------: | :------------------------------------------------------- | :---------------- |
15-
| `=` | Equal to | `123 = 123` |
16-
| `<>` | Not equal to | `123 <> 456` |
17-
| `!=` | Not equal to | `123 != 456` |
18-
| `>` | Greater than | `3 > 2` |
19-
| `>=` | Greater than or equal to | `3 >= 2` |
20-
| `<` | Less than | `1 < 2` |
21-
| `<=` | Less than or equal to | `1 <= 2` |
22-
| `~` | Matches a regular expression | `'abc' ~ 'a.*'` |
23-
| `~*` | Matches a regular expression _(case-insensitive)_ | `'Abc' ~* 'A.*'` |
24-
| `!~` | Does not match a regular expression | `'abc' !~ 'd.*'` |
25-
| `!~*` | Does not match a regular expression _(case-insensitive)_ | `'Abc' !~* 'a.*'` |
13+
| Operator | Meaning | Example |
14+
| :--------------------: | :------------------------------------------------------- | :------------------------- |
15+
| `=` | Equal to | `123 = 123` |
16+
| `<>` | Not equal to | `123 <> 456` |
17+
| `!=` | Not equal to | `123 != 456` |
18+
| `>` | Greater than | `3 > 2` |
19+
| `>=` | Greater than or equal to | `3 >= 2` |
20+
| `<` | Less than | `1 < 2` |
21+
| `<=` | Less than or equal to | `1 <= 2` |
22+
| `IS DISTINCT FROM` | Is distinct from | `0 IS DISTINCT FROM 1` |
23+
| `IS NOT DISTINCT FROM` | Is not distinct from | `0 IS NOT DISTINCT FROM 1` |
24+
| `~` | Matches a regular expression | `'abc' ~ 'a.*'` |
25+
| `~*` | Matches a regular expression _(case-insensitive)_ | `'Abc' ~* 'A.*'` |
26+
| `!~` | Does not match a regular expression | `'abc' !~ 'd.*'` |
27+
| `!~*` | Does not match a regular expression _(case-insensitive)_ | `'Abc' !~* 'a.*'` |
2628
2729
source: /content/shared/sql-reference/operators/comparison.md
2830
---

‎content/influxdb3/cloud-serverless/reference/sql/functions/binary-string.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
title: SQL binary string functions
3+
list_title: Binary string functions
4+
description: >
5+
Use binary string functions to encode and decode binary string values in
6+
SQL queries.
7+
menu:
8+
influxdb3_cloud_serverless:
9+
name: Binary string
10+
parent: sql-functions
11+
weight: 308
12+
13+
source: /content/shared/sql-reference/functions/binary-string.md
14+
---
15+
16+
<!--
17+
The content of this page is at
18+
// SOURCE /content/shared/sql-reference/functions/binary-string.md
19+
-->

‎content/influxdb3/cloud-serverless/reference/sql/functions/hashing.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
title: SQL hashing functions
3+
list_title: Hashing functions
4+
description: >
5+
Use hashing functions to hash string values in SQL queries using established
6+
hashing algorithms.
7+
menu:
8+
influxdb3_cloud_serverless:
9+
name: Hashing
10+
parent: sql-functions
11+
weight: 309
12+
13+
source: /shared/sql-reference/functions/hashing.md
14+
---
15+
16+
<!--
17+
The content for this page is at
18+
// SOURCE /content/shared/sql-reference/functions/hashing.md
19+
-->

‎content/influxdb3/cloud-serverless/reference/sql/operators/comparison.md

Lines changed: 15 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -10,19 +10,21 @@ menu:
1010
parent: Operators
1111
weight: 302
1212
list_code_example: |
13-
| Operator | Meaning | Example |
14-
| :------: | :------------------------------------------------------- | :---------------- |
15-
| `=` | Equal to | `123 = 123` |
16-
| `<>` | Not equal to | `123 <> 456` |
17-
| `!=` | Not equal to | `123 != 456` |
18-
| `>` | Greater than | `3 > 2` |
19-
| `>=` | Greater than or equal to | `3 >= 2` |
20-
| `<` | Less than | `1 < 2` |
21-
| `<=` | Less than or equal to | `1 <= 2` |
22-
| `~` | Matches a regular expression | `'abc' ~ 'a.*'` |
23-
| `~*` | Matches a regular expression _(case-insensitive)_ | `'Abc' ~* 'A.*'` |
24-
| `!~` | Does not match a regular expression | `'abc' !~ 'd.*'` |
25-
| `!~*` | Does not match a regular expression _(case-insensitive)_ | `'Abc' !~* 'a.*'` |
13+
| Operator | Meaning | Example |
14+
| :--------------------: | :------------------------------------------------------- | :------------------------- |
15+
| `=` | Equal to | `123 = 123` |
16+
| `<>` | Not equal to | `123 <> 456` |
17+
| `!=` | Not equal to | `123 != 456` |
18+
| `>` | Greater than | `3 > 2` |
19+
| `>=` | Greater than or equal to | `3 >= 2` |
20+
| `<` | Less than | `1 < 2` |
21+
| `<=` | Less than or equal to | `1 <= 2` |
22+
| `IS DISTINCT FROM` | Is distinct from | `0 IS DISTINCT FROM 1` |
23+
| `IS NOT DISTINCT FROM` | Is not distinct from | `0 IS NOT DISTINCT FROM 1` |
24+
| `~` | Matches a regular expression | `'abc' ~ 'a.*'` |
25+
| `~*` | Matches a regular expression _(case-insensitive)_ | `'Abc' ~* 'A.*'` |
26+
| `!~` | Does not match a regular expression | `'abc' !~ 'd.*'` |
27+
| `!~*` | Does not match a regular expression _(case-insensitive)_ | `'Abc' !~* 'a.*'` |
2628
2729
source: /content/shared/sql-reference/operators/comparison.md
2830
---

‎content/influxdb3/clustered/install/_index.md

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -37,14 +37,22 @@ installing InfluxDB Clustered.
3737

3838
## Setup, configure, and deploy InfluxDB Clustered
3939

40-
{{< children type="ordered-list" >}}
40+
> [!Note]
41+
> #### Deploying in air-gapped environments
42+
>
43+
> To deploy InfluxDB Clustered in an air-gapped environment (without internet access),
44+
> use one of the following approaches:
45+
>
46+
> - **Recommended**: Directly use `kubit local apply`
47+
> - Helm (includes the kubit operator)
48+
> - Directly use the kubit operator
49+
>
50+
> For more information, see [Choose the right deployment tool for your environment](/influxdb3/clustered/install/set-up-cluster/configure-cluster/#choose-the-right-deployment-tool-for-your-environment)
4151
52+
{{< children type="ordered-list" >}}
4253

4354
<!-- TODO: ADD CLUSTER ARCHITECTURE OVERVIEW -->
44-
45-
<!--
46-
47-
-------- TODO: ALL THIS INFORMATION NEEDS TO LAND IN THE ADMIN SECTION ---------
55+
<!---------- TODO: ALL THIS INFORMATION NEEDS TO LAND IN THE ADMIN SECTION ---------
4856
4957
### Updating your InfluxDB Cluster
5058

‎content/influxdb3/clustered/install/set-up-cluster/configure-cluster/_index.md

Lines changed: 57 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,9 +20,64 @@ The AppInstance CRD is defined in a YAML file (use the `example-customer.yml`
2020
provided by InfluxData as a template).
2121

2222
We recommend editing the `AppInstance` resource directly as the primary method
23-
for configuring and managing your InfluxDB cluster. If you are required to use
24-
[Helm](https://helm.sh/), there is a InfluxDB Clustered Helm chart available
23+
for configuring and managing your InfluxDB cluster.
24+
After you have edited your `AppInstance`, use the `kubit` CLI or `kubectl` [deployment tool](/influxdb3/clustered/install/set-up-cluster/configure-cluster/#choose-the-right-deployment-tool-for-your-environment), depending on your requirements.
25+
26+
If you are required to use
27+
[Helm](https://helm.sh/), there is an InfluxDB Clustered Helm chart available
2528
that acts as a wrapper for the `AppInstance` resource and lets you use Helm to
2629
manage configuration changes in your InfluxDB cluster.
2730

31+
{{% expand-wrapper %}}
32+
{{% expand "Choose the right deployment tool for your environment" %}}
33+
34+
| Deployment Tool | Best For | Requirements | Considerations |
35+
|----------------|----------|--------------|----------------|
36+
| [**kubectl**](#when-to-use-kubectl) | Standard deployments | Cluster-wide permissions | Simplest option if you have required permissions |
37+
| [**kubit CLI**](#when-to-use-kubit-cli) | Limited permission environments or air-gapped | Local workstation access | Better for environments with permission restrictions |
38+
| [**Helm**](#when-to-use-helm) | Teams standardized on Helm | Helm installation (includes kubit operator) | Provides consistent deployment with other Helm-managed applications |
39+
40+
### When to use kubectl
41+
42+
Use the `kubectl` approach when:
43+
44+
- You have cluster-wide permissions to install CRDs
45+
- You prefer the simplest deployment method
46+
47+
> [!important]
48+
>
49+
> #### kubectl requires cluster-wide permissions
50+
>
51+
> InfluxDB Clustered uses an `AppInstance` Kubernetes custom resource (CR) to
52+
> configure and deploy your InfluxDB Cluster. Installing a `CustomResourceDefinition`
53+
> (CRD) requires cluster-wide permissions, so if you don't have these permissions,
54+
> `kubectl` may fail.
55+
56+
### When to use kubit CLI
57+
58+
Use the `kubit local apply` CLI approach when:
59+
60+
- You don't have permissions to install CRDs
61+
- You don't have permissions to install operators in the `kubit` namespace
62+
- You don't have permissions to create cluster-wide RBAC
63+
- You're working in an air-gapped environment
64+
- You want to preview generated YAML before applying
65+
- You don't want to run the operator in your cluster
66+
67+
The `kubit local apply` method is specifically designed to avoid having to install the operator in air-gapped environments, making it easier to implement. This approach processes the AppInstance resource on your local machine and then applies the resulting Kubernetes resources directly to the cluster without requiring the kubit operator to be running in the cluster.
68+
69+
### When to use Helm
70+
71+
Use the `Helm` approach when:
72+
73+
- Your team is standardized on Helm for Kubernetes deployments
74+
- You prefer consistent deployment methods across applications
75+
- You want simplified management of the full stack
76+
- You need better support for upgrades and rollbacks
77+
78+
The InfluxDB Clustered Helm chart includes the [kubecfg kubit operator](/influxdb3/clustered/install/set-up-cluster/configure-cluster/use-helm/#kubecfg-kubit-operator).
79+
80+
{{% /expand %}}
81+
{{% /expand-wrapper %}}
82+
2883
{{< children >}}

0 commit comments

Comments
 (0)