Installing Using Docker

Running a Node

Run GridGain in a docker container using the docker run command. Docker will automatically pull the appropriate GridGain version:

docker run -d -p 10300:10300 -p 10800:10800 -p 3344:3344 gridgain/gridgain9:latest

This command launches a single GridGain node. After you run the command, you can check if GridGain is running in the container logs.

Running a Cluster

You can use the docker-compose file to start an entire cluster in docker. You can download a sample docker-compose file and run a 3-node cluster:

Download the docker-compose and node configuration that will be used by docker compose.
Download the docker image:
```
docker pull gridgain/gridgain9:latest
```
Run the docker compose command. The node configuration should be in the same folder as docker compose file:
```
docker compose -f packaging/docker/docker-compose.yml up -d
```

3 nodes will start in docker and will be available from CLI tool that can be run locally. Remember to initialise the cluster from the command line tool before working with it.

Running CLI Tool in Docker

CLI tool is used to manage GridGain nodes. By default, docker nodes are isolated and run on different networks, so CLI tool will not be able to connect to the target container from another container. To fix that, you need to create a network and add all containers running the nodes to it.

Create a new network with the network create command:
```
docker network create gridgain-network
```
Add any containers with nodes that are already running to the network:
```
docker network connect gridgain-network {container-id}
```

Start the container with the GridGain CLI tool on the same network:

docker run -p 10301:10300 -p 10801:10800 -p 3345:3344 -it --network=gridgain-network gridgain/gridgain9:latest cli

The CLI will be able to connect to the IP address of the node. If you are not sure what the address is, use the container inspect command to check it:

docker container inspect {container-id}

© 2024 GridGain Systems, Inc. All Rights Reserved. Privacy Policy | Legal Notices. GridGain® is a registered trademark of GridGain Systems, Inc.
Apache, Apache Ignite, the Apache feather and the Apache Ignite logo are either registered trademarks or trademarks of The Apache Software Foundation.

Last updated on Dec 18, 2024