diff --git a/content/enterprise_influxdb/v1/introduction/installation/docker/_index.md b/content/enterprise_influxdb/v1/introduction/installation/docker/_index.md index 5f3507b81..a1c6c40be 100644 --- a/content/enterprise_influxdb/v1/introduction/installation/docker/_index.md +++ b/content/enterprise_influxdb/v1/introduction/installation/docker/_index.md @@ -8,6 +8,11 @@ menu: parent: Install related: - /enterprise_influxdb/v1/introduction/installation/docker/docker-troubleshooting/ +alt_links: + core: /influxdb3/core/get-started/setup/ + enterprise: /influxdb3/enterprise/get-started/setup/ + v1: /influxdb/v1/introduction/install/docker/ + v2: /influxdb/v2/install/use-docker-compose/ --- InfluxDB v1 Enterprise provides Docker images for both meta nodes and data nodes to simplify cluster deployment and management. @@ -18,6 +23,14 @@ Using Docker allows you to quickly set up and run InfluxDB Enterprise clusters w > You must have a valid license to run InfluxDB Enterprise. > Contact for licensing information or obtain a 14-day demo license via the [InfluxDB Enterprise portal](https://portal.influxdata.com/users/new). +- [Docker image variants](#docker-image-variants) +- [Requirements](#requirements) +- [Set up an InfluxDB Enterprise cluster with Docker](#set-up-an-influxdb-enterprise-cluster-with-docker) +- [Configuration options](#configuration-options) +- [Exposing ports](#exposing-ports) +- [Persistent data storage](#persistent-data-storage) +- [Next steps](#next-steps) + ## Docker image variants InfluxDB Enterprise provides two specialized Docker images: @@ -35,15 +48,23 @@ InfluxDB Enterprise provides two specialized Docker images: ## Set up an InfluxDB Enterprise cluster with Docker -### 1. Create a Docker network +1. [Create a Docker network](#create-a-docker-network) +2. [Start meta nodes](#start-meta-nodes) +3. [Configure meta nodes to know each other](#configure-meta-nodes-to-know-each-other) +4. [Start data nodes](#start-data-nodes) +5. [Add data nodes to the cluster](#add-data-nodes-to-the-cluster) +6. [Verify the cluster](#verify-the-cluster) +7. [Stop and restart InfluxDB v1 Enterprise Containers](#stop-and-restart-influxdb-v1-enterprise-containers) -Create a custom Docker network to allow communication between meta and data nodes: +### Create a Docker network -```bash -docker network create influxdb -``` + Create a custom Docker network to allow communication between meta and data nodes: -### 2. Start meta nodes + ```bash + docker network create influxdb + ``` + +### Start meta nodes Start three meta nodes using the `influxdb:meta` image. Each meta node requires a unique hostname and the Enterprise license key: @@ -74,7 +95,7 @@ docker run -d \ influxdb:meta ``` -### 3. Configure meta nodes to know each other +### Configure meta nodes to know each other From the first meta node, add the other meta nodes to the cluster: @@ -88,7 +109,7 @@ docker exec influxdb-meta-0 \ influxd-ctl add-meta influxdb-meta-2:8091 ``` -### 4. Start data nodes +### Start data nodes Start two or more data nodes using the `influxdb:data` image: @@ -110,7 +131,7 @@ docker run -d \ influxdb:data ``` -### 5. Add data nodes to the cluster +### Add data nodes to the cluster From the first meta node, register each data node with the cluster: @@ -124,7 +145,7 @@ docker exec influxdb-meta-0 \ influxd-ctl add-data influxdb-data-1:8088 ``` -### 6. Verify the cluster +### Verify the cluster Check that all nodes are properly added to the cluster: diff --git a/content/influxdb/v1/introduction/install/docker.md b/content/influxdb/v1/introduction/install/docker.md index 74a6b0405..f7b6297c1 100644 --- a/content/influxdb/v1/introduction/install/docker.md +++ b/content/influxdb/v1/introduction/install/docker.md @@ -16,12 +16,26 @@ related: - /influxdb/v1/administration/config/, Configure InfluxDB OSS v1 alt_links: core: /influxdb3/core/install/ + enterprise: /influxdb3/enterprise/install/ v2: /influxdb/v2/install/use-docker-compose/ --- Install and run InfluxDB OSS v1.x using Docker containers. This guide covers Docker installation, configuration, and initialization options. +- [Install and run InfluxDB](#install-and-run-influxdb) + - [Pull the InfluxDB v1.x image](#pull-the-influxdb-v1x-image) + - [Start InfluxDB](#start-influxdb) +- [Configure InfluxDB](#configure-influxdb) + - [Using environment variables](#using-environment-variables) + - [Using a configuration file](#using-a-configuration-file) +- [Initialize InfluxDB](#initialize-influxdb) + - [Automatic initialization (for development)](#automatic-initialization-for-development) + - [Custom initialization scripts](#custom-initialization-scripts) +- [Access the InfluxDB CLI](#access-the-influxdb-cli) +- [Next steps](#next-steps) + + ## Install and run InfluxDB ### Pull the InfluxDB v1.x image diff --git a/content/influxdb/v2/install/upgrade/v1-to-v2/docker.md b/content/influxdb/v2/install/upgrade/v1-to-v2/docker.md index 44143f0ea..634cd9188 100644 --- a/content/influxdb/v2/install/upgrade/v1-to-v2/docker.md +++ b/content/influxdb/v2/install/upgrade/v1-to-v2/docker.md @@ -17,18 +17,22 @@ Use the automated upgrade process built into the [InfluxDB 2.x Docker image](htt to update InfluxDB 1.x Docker deployments to InfluxDB 2.x. - [Upgrade requirements](#upgrade-requirements) + - [InfluxDB 2.x initialization credentials](#influxdb-2x-initialization-credentials) + - [File system mounts](#file-system-mounts) + - [Upgrade initialization mode](#upgrade-initialization-mode) - [Minimal upgrade](#minimal-upgrade) -- [Upgrade with a custom InfluxDB 1.x configuration file](#upgrade-with-a-custom-influxdb-1-x-configuration-file) +- [Upgrade with a custom InfluxDB 1.x configuration file](#upgrade-with-a-custom-influxdb-1x-configuration-file) - [Upgrade with custom paths](#upgrade-with-custom-paths) - [Use new InfluxDB tools](#use-new-influxdb-tools) + - [Migrate continuous queries to tasks](#migrate-continuous-queries-to-tasks) + - [Use the interactive InfluxQL shell](#use-the-interactive-influxql-shell) -{{% note %}} -#### Export continuous queries before upgrading -The automated upgrade process **does not** migrate InfluxDB 1.x continuous queries (CQs) -to InfluxDB 2.x tasks (the 2.x equivalent). Export all of your CQs before upgrading to InfluxDB 2.x. -For information about exporting and migrating CQs to tasks, see -[Migrate continuous queries to tasks](/influxdb/v2/upgrade/v1-to-v2/migrate-cqs/). -{{% /note %}} +> [!Note] +> #### Export continuous queries before upgrading +> The automated upgrade process **does not** migrate InfluxDB 1.x continuous queries (CQs) +> to InfluxDB 2.x tasks (the 2.x equivalent). Export all of your CQs before upgrading to InfluxDB 2.x. +> For information about exporting and migrating CQs to tasks, see +> [Migrate continuous queries to tasks](/influxdb/v2/upgrade/v1-to-v2/migrate-cqs/). ## Upgrade requirements InfluxDB 2.x provides a 1.x compatibility API, but expects a different storage layout on disk. @@ -253,21 +257,8 @@ docker run -p 8086:8086 \ {{< /tabs-wrapper >}} -## Use new InfluxDB tools -Once upgraded, use InfluxDB {{< current-version >}} tools to work with your time series data. - -- [Migrate continuous queries to tasks](#migrate-continuous-queries-to-tasks) -- [Use the interactive InfluxQL shell](#use-the-interactive-influxql-shell) - -### Migrate continuous queries to tasks - -InfluxDB {{< current-version >}} replaces continuous queries with **tasks**. -By default, the upgrade process writes all continuous queries to `~/continuous_queries.txt`. -To convert continuous queries to InfluxDB tasks, see -[Migrate continuous queries to tasks](/influxdb/v2/upgrade/v1-to-v2/migrate-cqs/). - -### Use the interactive InfluxQL shell +## Use the interactive InfluxQL shell The InfluxDB {{< current-version >}} `influx` CLI includes an interactive **InfluxQL shell** for executing InfluxQL queries. The InfluxDB {{< current-version >}} Docker image includes the `influx` CLI. diff --git a/content/influxdb/v2/install/use-docker-compose.md b/content/influxdb/v2/install/use-docker-compose.md index 79b204218..74484d51e 100644 --- a/content/influxdb/v2/install/use-docker-compose.md +++ b/content/influxdb/v2/install/use-docker-compose.md @@ -9,21 +9,31 @@ weight: 2 influxdb/v2/tags: [install] related: - /influxdb/v2/install/ + - /influxdb/v2/install/upgrade/v1-to-v2/docker/ - /influxdb/v2/reference/cli/influx/auth/ - /influxdb/v2/reference/cli/influx/config/ - /influxdb/v2/reference/cli/influx/ - /influxdb/v2/admin/tokens/ alt_links: v1: /influxdb/v1/introduction/install/docker/ + core: /influxdb3/core/get-started/setup/ + enterprise: /influxdb3/enterprise/get-started/setup/ --- Use Docker Compose to install and set up InfluxDB v2, the time series platform -is purpose-built to collect, store, process and visualize metrics and events. +purpose-built to collect, store, process and visualize metrics and events. -When you use Docker Compose to create an InfluxDB container, you can use -Compose [`secrets`](https://docs.docker.com/compose/use-secrets/) to control -access to sensitive credentials such as username, password, and token and -prevent leaking them in your `docker inspect` output. +- [Set up using Docker Compose secrets](#set-up-using-docker-compose-secrets) + - [Run InfluxDB CLI commands in a container](#run-influxdb-cli-commands-in-a-container) + - [Manage files in mounted volumes](#manage-files-in-mounted-volumes) + +## Set up using Docker Compose secrets + +> [!Tip] +> When you use Docker Compose to create an InfluxDB container, you can use +> Compose [`secrets`](https://docs.docker.com/compose/use-secrets/) to control +> access to sensitive credentials such as username, password, and token and +> prevent leaking them in your `docker inspect` output. The `influxdb` Docker image provides the following environment variables to use with Compose `secrets`: @@ -37,8 +47,6 @@ variables to use with Compose `secrets`: [Operator token](/influxdb/v2/admin/tokens/#operator-token). If you don't specify an initial token, InfluxDB generates one for you. -## Set up using Docker Compose secrets - Follow steps to set up and run InfluxDB using Docker Compose and `secrets`: 1. If you haven't already, install @@ -83,6 +91,8 @@ Follow steps to set up and run InfluxDB using Docker Compose and `secrets`: influxdb2-config: ``` + _For more information about initialization environment variables, see the [upgrade guide](/influxdb/v2/install/upgrade/v1-to-v2/docker/)._ + 3. For each secret in `compose.yaml`, create a file that contains the secret value--for example: