You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+16-6Lines changed: 16 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,7 +19,7 @@ bulckan will show in the logs all the steps to deploy the compose file. It will
19
19
20
20
bulckan only monitors changes in the specified path and will only update the configuration of the docker compose file. It does not monitor if the images have been updated, use [Watchtower](https://containrrr.dev/watchtower/?ref=selfh.st) for that by deploying it with bulckan or implement a workflow that changes the image version in the compose when the image is rebuilt.
21
21
22
-
Note: To test the functionality, it is possible to deploy bulckan as configured. The application points to a branch of the same repository with the Docker Compose files needed to deploy an Apache container.
22
+
Note: To test the functionality, it is possible to deploy bulckan as configured. The application points to a branch of the same repository that contains the [compose files](https://github.com/dockopslab/bulckan/tree/example/bulckan-target) needed to deploy one or more Apache containers.
23
23
24
24
## Configuration
25
25
First, clone this repository and navigate to the project directory:
Configure the ``.env`` file to access the repository, branch and path where the docker-compose.yml file you want to deploy and maintain with this tool is located:
32
+
Configure the ``.env`` file to access the repository, branch and path where the compose file you want to deploy and maintain with this tool is located:
33
33
34
34
```
35
35
GITHUB_URL=github.com/dockopslab/bulckan.git
@@ -96,19 +96,29 @@ By adding the following tags to the target application's compose file, informati
96
96
- "bulckan.deploy.last_commit=${LAST_COMMIT}"
97
97
```
98
98
99
+
See an example in this [compose file](https://github.com/dockopslab/bulckan/blob/example/bulckan-target/sample/docker-compose.yml).
100
+
99
101
# Multiple deployment configuration
100
102
101
103
bulckan can be deployed multiple times, so it can point to different repositories and keep different applications updated and deployed at the same time.
102
104
103
-
Configure .git.env file if necessary:
105
+
If necessary, configure the ``.git.env`` file:
104
106
```
105
107
GITHUB_USERNAME=
106
108
GITHUB_TOKEN=
107
109
```
108
110
109
-
Configure environment variables in docker-compose.example.yml:
111
+
Configure environment variables in ``compose.example.yml``:
110
112
```
111
-
version: '3.8'
113
+
name: 'bulckan-example'
114
+
115
+
networks:
116
+
bulckan:
117
+
118
+
volumes:
119
+
repo1:
120
+
repo2:
121
+
repo3:
112
122
113
123
services:
114
124
bulckan1:
@@ -141,7 +151,7 @@ services:
141
151
bulckan deployment:
142
152
143
153
```
144
-
docker-compose -f docker-compose.example.yml up -d
154
+
docker-compose -f compose.example.yml up -d
145
155
```
146
156
147
157
Note: Before deploying multiple docker-compose.yml with Bulckan, it is necessary to check for possible incompatibilities. Errors due to duplication of exposed ports, service names, networks, and others must be corrected before deployment.
0 commit comments