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: update_sitebuilder.md
+26-25Lines changed: 26 additions & 25 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ git status
15
15
16
16
>status should be up-to-date and point to `main` git branch.
17
17
18
-
* Define docker image tag, e.g., `1.5.5` typically a level up than [the current version](https://hub.docker.com/r/sbamin/sitebuilder/tags). You need to manually update several of commands below to reflect an updated tag.
18
+
* Define docker image tag, e.g., `1.5.6` typically a level up than [the current version](https://hub.docker.com/r/sbamin/sitebuilder/tags). You need to manually update several of commands below to reflect an updated tag.
19
19
20
20
* Update `Dockerfile` as per your custom changes. At minimum, update LABEL version and mode to reflect an updated tag. You can also update `hugo extended` to the [current release](https://github.com/gohugoio/hugo/releases) by updating *myhugo* ENV variable in `Dockerfile`. Optionally, [update related go version](https://go.dev/doc/install) with *mygo* ENV variable.
>NOTE: If using docker on Mac M1/M2, you should add `--platform linux/amd64` given sitebuilder docker image is configured for amd64 and not arm64 architecture. To use arm64 architecture, you need to update `Dockerfile` to replace `amd64` packages with `arm64` ones, if available from a respective developer. [See relevant details here](https://stackoverflow.com/a/68004485/1243763).
34
34
35
35
* Optional: To build arm64 docker image, use a separate Dockerfile that installs arm64 packages of hugo and go.
PS: Rest of steps are implied for amd64 image, and can be followed for arm64 image too with applicable changes to docker image name.
@@ -45,7 +45,7 @@ PS: Rest of steps are implied for amd64 image, and can be followed for arm64 ima
45
45
```sh
46
46
## start container in an interactive session and mount local (host) directory
47
47
## to an empty location in the docker container.
48
-
docker run --platform linux/amd64 --rm -it -v "$(pwd)":/hostspace sbamin/sitebuilder:1.5.5 /bin/bash
48
+
docker run --platform linux/amd64 --rm -it -v "$(pwd)":/hostspace sbamin/sitebuilder:1.5.6 /bin/bash
49
49
50
50
## copy (overwrite) local Gemfile.lock with an updated version from
51
51
## the container
@@ -58,9 +58,9 @@ exit
58
58
* Check installed or updated package versions
59
59
60
60
```sh
61
-
docker run --platform linux/amd64 --rm sbamin/sitebuilder:1.5.5 /bin/bash -c "jekyll --version && hugo version && git version && go version && pip list | grep mkdocs"
61
+
docker run --platform linux/amd64 --rm sbamin/sitebuilder:1.5.6 /bin/bash -c "jekyll --version && hugo version && git version && go version && pip list | grep mkdocs"
62
62
63
-
docker run --platform linux/arm64 --rm sbamin/sitebuilder:1.5.5_arm64 /bin/bash -c "jekyll --version && hugo version && git version && go version && pip list | grep mkdocs"
63
+
docker run --platform linux/arm64 --rm sbamin/sitebuilder:1.5.6_arm64 /bin/bash -c "jekyll --version && hugo version && git version && go version && pip list | grep mkdocs"
## -s requires a valid gpg key for signing a message
73
73
git commit -s -F- <<EOF
74
74
Updated sitebuilder
75
-
v1.5.5
75
+
v1.5.6
76
76
77
77
## amd64
78
78
79
79
jekyll 3.10.0
80
-
hugo v0.141.0-e7bd51698e5c3778a86003018702b1a7dcb9559a+extended linux/amd64 BuildDate=2025-01-16T13:11:18Z VendorInfo=gohugoio
80
+
hugo v0.144.2-098c68fd18f48031a7145bedab30cbaede48858f+extended linux/amd64 BuildDate=2025-02-19T12:17:04Z VendorInfo=gohugoio
81
81
git version 2.39.5
82
-
go version go1.23.5 linux/amd64
82
+
go version go1.24.0 linux/amd64
83
83
mkdocs 1.6.1
84
84
mkdocs-get-deps 0.2.0
85
85
mkdocs-git-authors-plugin 0.9.2
86
-
mkdocs-git-committers-plugin-2 2.4.1
86
+
mkdocs-git-committers-plugin-2 2.5.0
87
87
mkdocs-git-revision-date-localized-plugin 1.3.0
88
88
mkdocs-git-revision-date-plugin 0.3.2
89
89
mkdocs-glightbox 0.4.0
90
90
mkdocs-macros-plugin 1.3.7
91
-
mkdocs-material 9.5.50
91
+
mkdocs-material 9.6.5
92
92
mkdocs-material-extensions 1.3.1
93
93
mkdocs-minify-plugin 0.8.0
94
94
mkdocs-redirects 1.2.2
@@ -97,18 +97,18 @@ mkdocs-rss-plugin 1.17.1
97
97
## arm64
98
98
99
99
jekyll 3.10.0
100
-
hugo v0.141.0-e7bd51698e5c3778a86003018702b1a7dcb9559a+extended linux/arm64 BuildDate=2025-01-16T13:11:18Z VendorInfo=gohugoio
100
+
hugo v0.144.2-098c68fd18f48031a7145bedab30cbaede48858f+extended linux/arm64 BuildDate=2025-02-19T12:17:04Z VendorInfo=gohugoio
101
101
git version 2.39.5
102
-
go version go1.23.5 linux/arm64
102
+
go version go1.24.0 linux/arm64
103
103
mkdocs 1.6.1
104
104
mkdocs-get-deps 0.2.0
105
105
mkdocs-git-authors-plugin 0.9.2
106
-
mkdocs-git-committers-plugin-2 2.4.1
106
+
mkdocs-git-committers-plugin-2 2.5.0
107
107
mkdocs-git-revision-date-localized-plugin 1.3.0
108
108
mkdocs-git-revision-date-plugin 0.3.2
109
109
mkdocs-glightbox 0.4.0
110
110
mkdocs-macros-plugin 1.3.7
111
-
mkdocs-material 9.5.50
111
+
mkdocs-material 9.6.5
112
112
mkdocs-material-extensions 1.3.1
113
113
mkdocs-minify-plugin 0.8.0
114
114
mkdocs-redirects 1.2.2
@@ -123,21 +123,22 @@ git push
123
123
124
124
Upload your docker image to [docker hub](https://www.docker.com), [github packages](https://github.com/features/packages), or your preferred container hub.
125
125
126
-
* Tag or alias updated image to `latest`. This will overwrite existing alias to `latest` which is typically an older image, e.g., 1.5.1
126
+
* Tag or alias updated image to `latest`. This will overwrite existing alias to `latest` which is typically an older image, e.g., 1.x.x
127
127
128
128
```sh
129
129
## unless beta version, remove older docker image tagged as latest, if any on local computer.
130
130
docker rmi sbamin/sitebuilder:latest
131
-
docker tag sbamin/sitebuilder:1.5.5 sbamin/sitebuilder:latest
131
+
docker tag sbamin/sitebuilder:1.5.6 sbamin/sitebuilder:latest
132
132
```
133
133
134
134
* Besides updating Docker Hub, if you are updating image also to github packages, update respective aliases.
135
135
136
136
```sh
137
137
## unless beta version, remove older versions
138
138
docker rmi ghcr.io/sbamin/sitebuilder:latest
139
-
docker tag sbamin/sitebuilder:1.5.5 ghcr.io/sbamin/sitebuilder:1.5.5
140
-
docker tag ghcr.io/sbamin/sitebuilder:1.5.5 ghcr.io/sbamin/sitebuilder:latest
139
+
docker tag sbamin/sitebuilder:1.5.6 ghcr.io/sbamin/sitebuilder:1.5.6
140
+
docker tag ghcr.io/sbamin/sitebuilder:1.5.6 ghcr.io/sbamin/sitebuilder:latest
141
+
docker tag sbamin/sitebuilder:1.5.6_arm64 ghcr.io/sbamin/sitebuilder:1.5.6_arm64
141
142
```
142
143
143
144
* Confirm using `docker images` that IMAGE ID of a built image, `sbamin/sitebuilder:1.5.x` matches with aliases created above. If all good, remove previous version of sitebuilder, `docker rmi sbamin/sitebuilder:1.5.4`
@@ -147,9 +148,9 @@ docker tag ghcr.io/sbamin/sitebuilder:1.5.5 ghcr.io/sbamin/sitebuilder:latest
147
148
* Push images to docker hub and/or github packages. For github container registry, see [this guide](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry) on authentication.
148
149
149
150
```sh
150
-
docker push sbamin/sitebuilder:1.5.5
151
+
docker push sbamin/sitebuilder:1.5.6
151
152
docker push sbamin/sitebuilder:latest
152
-
docker push sbamin/sitebuilder:1.5.5_arm64
153
+
docker push sbamin/sitebuilder:1.5.6_arm64
153
154
```
154
155
155
156
* If using github container repo, this should work.
0 commit comments