Skip to content

Commit 207649e

Browse files
Merge pull request #136 from OctoPrint/create-CHANGELOG
add CHANGELOG.md
2 parents abf782e + 55e77e7 commit 207649e

File tree

1 file changed

+120
-0
lines changed

1 file changed

+120
-0
lines changed

CHANGELOG.md

Lines changed: 120 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,120 @@
1+
## Version 3.0.0 Changelog
2+
3+
- plugins will now persist in the `/octoprint` volume (see #71 and #44)
4+
- Settings unique to docker (such as restarting octoprint and webcam configs), are now pre-configured (implemented in #132)
5+
- Backup/restore will now work with the docker image (fixed #92 via #135)
6+
- the creation of `edge`, `canary`, and `bleeding` tags. See README for details on how to use these tags
7+
8+
### Breaking changes
9+
10+
PR #135 introduced a change that will not affect most users, but may be a breaking change for existing users that are using a volume mounting strategy other than the recommended strategy. Details follow:
11+
12+
- `/octoprint/octoprint` and `/octoprint/plugins` folders are now explicitly created during docker build
13+
- octoprint service basedir is now `/octoprint/octoprint` (was previously `/octoprint`)
14+
- the recommended mount path for the `config-editor` container to has been changed to `octoprint:/octoprint`. See updated examples and usage info in `docker-compose.yml` and `README`.
15+
16+
Due to the changes of the folder structure below the `/octoprint` directory, where before the root context of the volume mount looked like this:
17+
18+
```
19+
/octoprint
20+
├── config.backup
21+
├── config.yaml
22+
├── data
23+
│ ├── announcements
24+
│ ├── appkeys
25+
│ ├── backup
26+
│ ├── pluginmanager
27+
│ ├── preemptive_cache_config.yaml
28+
│ └── softwareupdate
29+
├── generated
30+
│ └── webassets
31+
├── logs
32+
│ ├── octoprint.log
33+
│ ├── plugin_bedlevelvisualizer_debug.log
34+
│ ├── plugin_pluginmanager_console.log
35+
│ └── plugin_softwareupdate_console.log
36+
├── octoprint
37+
│ ├── config.backup
38+
│ ├── config.yaml
39+
│ ├── data
40+
│ ├── generated
41+
│ ├── logs
42+
│ ├── plugins
43+
│ ├── printerProfiles
44+
│ ├── scripts
45+
│ ├── slicingProfiles
46+
│ ├── timelapse
47+
│ ├── translations
48+
│ ├── uploads
49+
│ ├── users.yaml
50+
│ ├── virtualSd
51+
│ └── watched
52+
├── plugins
53+
│ ├── bin
54+
│ └── lib
55+
├── printerProfiles
56+
│ └── _default.profile
57+
├── scripts
58+
├── slicingProfiles
59+
├── timelapse
60+
│ └── tmp
61+
├── translations
62+
├── uploads
63+
├── virtualSd
64+
└── watched
65+
```
66+
It will now look like this:
67+
68+
```
69+
/octoprint
70+
├── octoprint
71+
│ ├── config.backup
72+
│ ├── config.yaml
73+
│ ├── data
74+
│ ├── generated
75+
│ ├── logs
76+
│ ├── plugins
77+
│ ├── printerProfiles
78+
│ ├── scripts
79+
│ ├── slicingProfiles
80+
│ ├── timelapse
81+
│ ├── translations
82+
│ ├── uploads
83+
│ ├── virtualSd
84+
│ └── watched
85+
└── plugins
86+
```
87+
88+
The `/octoprint/plugins` directory is the python libraries path, and `/octoprint/octoprint/plugins`
89+
is the path for plugin data and configuration. Prior to this change, both of these things
90+
existed in the `/octoprint/plugins` folder, polluting it's purpose.
91+
92+
This new method will allow savvy users to create distinct volumes for plugin binaries and
93+
octoprint configuration data, giving them more ability to selectively control how state and
94+
memory consumption are utilized in their octoprint image usage/distribution strategies.
95+
96+
## 2.0.0
97+
98+
### BREAKING CHANGES
99+
100+
- All usage of `MJPEG` has been replaced with `MJPG` for consistency. For now,values passed to `MJPEG_STREAMER_INPUT` will be coerced for backwards compatibility
101+
- Webcam support is now _disabled_ by default, and enabled by passing the environment variable `ENABLE_MJPG_STREAMER=true`
102+
103+
## 1.0.0
104+
105+
BREAKING CHANGES for all existing users on their next pull, as this image will replace the existing tagged images once this PR is accepted. We should increased traffic here and on discord for a while. @foosel it would probably be good to add a blog post about this, or include a snippet of info about it in the next blog post. If you want me to author that content, just let me know what approach you want to take.
106+
107+
1.0.0 This will be considered the 1.0.0 release of the official image for octoprint, and will be tagged as such in this git repo once accepted.
108+
109+
Overview
110+
Changed Docker.camera to Dockerfile
111+
updated workflows
112+
updated usage documentation for usage instructions
113+
Changes
114+
made the container volume for configs /octoprint, which is symlinked to ~/.octoprint (this was /data for the @nunofgs image
115+
primary container port is now 80 (was formerly 5000 for the default image, and 8888 for the -camera image
116+
removed cura (will add to feature backlog). Existing implementation was not working anyways, and now that we're s6 based, we need to set it up as a service
117+
Other
118+
added a web-accessible configuration editor service to the example compose file (see usage docs in README)
119+
moved the old Dockerfile to /minimal folder, for the eventuality that we'll create a single process image container only octoprint at some point in the future
120+
@nunofgs this should bring the official image completely in line with your nunofgs/octoprint image, meaning you can now archive github.com/nunofgs/docker-octoprint

0 commit comments

Comments
 (0)