Refactor: Reorganize services into standalone structure
This commit is contained in:
39
optimized/standalone/Portainer_Agent_Standalone/README.md
Normal file
39
optimized/standalone/Portainer_Agent_Standalone/README.md
Normal file
@@ -0,0 +1,39 @@
|
||||
# Portainer Agent (Standalone Host)
|
||||
|
||||
This directory contains the `docker-compose.yml` for deploying a Portainer Agent on a standalone Docker (or Podman) host. This agent allows a central Portainer instance (potentially running in a Swarm) to manage this individual host.
|
||||
|
||||
## Running with Podman Compose
|
||||
|
||||
To deploy the Portainer Agent using `podman-compose`:
|
||||
|
||||
1. Navigate to this directory:
|
||||
```bash
|
||||
cd optimized/standalone/Portainer_Agent_Standalone
|
||||
```
|
||||
2. **Important**: Replace `192.168.1.81` with the actual IP address or resolvable hostname of your Portainer Server instance in the `docker-compose.yml`.
|
||||
3. Start the agent:
|
||||
```bash
|
||||
podman-compose up -d
|
||||
```
|
||||
|
||||
## Running with Podman
|
||||
|
||||
You can run the Portainer Agent directly with Podman:
|
||||
|
||||
```bash
|
||||
podman run -d \
|
||||
--name portainer-agent \
|
||||
--restart always \
|
||||
-v /var/run/docker.sock:/var/run/docker.sock \
|
||||
-v /var/lib/docker/volumes:/var/lib/docker/volumes \
|
||||
-e AGENT_CLUSTER_ADDR=192.168.1.81 \
|
||||
-e AGENT_PORT=9001 \
|
||||
-p "9001:9001" \
|
||||
portainer/agent:latest
|
||||
```
|
||||
|
||||
## Notes
|
||||
|
||||
* This agent is specifically for managing a *standalone* Docker/Podman host. If you intend to manage a Swarm cluster, the Portainer Swarm stack (found in `optimized/swarm/Portainer`) should be used, which typically deploys agents globally across the Swarm nodes.
|
||||
* The volumes `/var/run/docker.sock` and `/var/lib/docker/volumes` are critical for the agent to communicate with and manage the Docker/Podman daemon.
|
||||
* Ensure `AGENT_CLUSTER_ADDR` points to your actual Portainer Server.
|
||||
@@ -0,0 +1,14 @@
|
||||
version: '3.8'
|
||||
services:
|
||||
portainer-agent:
|
||||
image: portainer/agent:latest
|
||||
container_name: portainer-agent
|
||||
volumes:
|
||||
- /var/run/docker.sock:/var/run/docker.sock
|
||||
- /var/lib/docker/volumes:/var/lib/docker/volumes
|
||||
environment:
|
||||
AGENT_CLUSTER_ADDR: 192.168.1.81 # Replace with the actual IP address
|
||||
AGENT_PORT: 9001
|
||||
ports:
|
||||
- "9001:9001" # Port for agent communication
|
||||
restart: always
|
||||
Reference in New Issue
Block a user