Пайплайн сборки контейнера с готовой документацией

.gitea/workflows/build.yml

@@ -0,0 +1,44 @@
+# https://docs.gitea.com/usage/actions/overview
+# https://docs.github.com/ru/actions/reference/workflows-and-actions/contexts
+
+name: Build images
+
+on:
+  push:
+    branches:
+      - 'master'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with: # https://github.com/actions/checkout
+          fetch-depth: 0
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+        with: # https://github.com/docker/setup-buildx-action
+          buildkitd-config-inline: |
+            # https://github.com/moby/buildkit/blob/master/docs/buildkitd.toml.md
+            [ registry."docker.io" ]
+            mirrors = ["https://dockerhub.timeweb.cloud", "https://dh-mirror.gitverse.ru"]
+            http = true
+            insecure = true
+
+      - name: Log in to Gitea Container Registry
+        uses: docker/login-action@v3
+        with: # https://github.com/docker/login-action
+          registry: git.axenov.dev
+          username: ${{ secrets.USERNAME }}
+          password: ${{ secrets.RELEASE_TOKEN }}
+
+      - name: Build and push Docker images
+        uses: docker/build-push-action@v5
+        with: # https://github.com/docker/build-push-action
+          context: .
+          push: true
+          tags: |
+            git.axenov.dev/iptv/m3u-su-docs:${{ github.ref_name }}
+            git.axenov.dev/iptv/m3u-su-docs:latest

Makefile

@@ -1,4 +1,4 @@
-## image: Run mkdocs with live-reloading
+## image: Run mkdocs with live-reloading (localhost:3000)
 live:
 	@echo "Wait until container starts and open http://localhost:3000 to see live preview"
 	@docker run \
@@ -6,18 +6,21 @@ live:
 		--rm \
 		--interactive \
 		--tty \
-		-p 3000:8000 \
+		--publish 3000:8000 \
-		-v ${PWD}:/docs \
+		--volume ${PWD}:/docs \
+		--name m3u-su-docs-builder \
 		squidfunk/mkdocs-material:9.6.20
 
 ## image: Build local static site
 build:
+	@echo "Wait until mkdocs finish"
 	@docker run \
 		--pull always \
 		--rm \
 		--interactive \
 		--tty \
-		-v ${PWD}:/docs \
+		--volume ${PWD}:/docs \
+		--name m3u-su-docs-builder \
 		squidfunk/mkdocs-material:9.6.20 build
 
 ## image: Build docker image
@@ -31,9 +34,14 @@ image:
 push:
 	@docker push git.axenov.dev/iptv/m3u-su-docs:latest
 
-## push: Push docker image to registry
+## run: Run docker image (localhost:3001)
 run:
-	@docker run -p 3001:80 git.axenov.dev/iptv/m3u-su-docs:latest
+	@echo "Wait until container starts and open http://localhost:3001 to see ready static website"
+	@docker run \
+		--rm \
+		--publish 3001:80 \
+		--name m3u-su-docs \
+		git.axenov.dev/iptv/m3u-su-docs:latest
 
 ## help: Show this message and exit
 help: Makefile

src/index.md

@@ -9,10 +9,11 @@ icon: material/home
 
 !!! info "Все необходимые адреса"
     **Веб-сайт:** [m3u.su](https://m3u.su)  
+    **Документация:** [m3u.su/docs](https://m3u.su/docs)  
     Исходный код: [git.axenov.dev/IPTV](https://git.axenov.dev/IPTV)  
-    Новостной канал: [@iptv_aggregator](https://t.me/iptv_aggregator)  
+    Telegram-канал: [@iptv_aggregator](https://t.me/iptv_aggregator)  
-    Обсуждение: [@iptv_aggregator_chat](tg/chat.md)  
+    Обсуждение: [@iptv_aggregator_chat](https://t.me/iptv_aggregator_chat)  
-    Бот: [@iptv_aggregator_bot](tg/bot.md)
+    Бот: [@iptv_aggregator_bot](https://t.me/iptv_aggregator_bot)  
 
 Далеко не все пользователи, желающие использовать цифровое ТВ, могут позволить себе подключение IPTV у своего провайдера или поставщиков контента.
 

src/iptvc/install.md

@@ -24,13 +24,13 @@ tags: ["iptvc"]
 Тег `latest` всегда соответствует последней версии, он подразумевается по умолчанию:
 
 ```shell
-docker run --pull always git.axenov.dev/iptv/iptvc КОМАНДА [АРГУМЕНТЫ]
+docker run --pull always --name iptvc git.axenov.dev/iptv/iptvc КОМАНДА [АРГУМЕНТЫ]
 ```
 
 Для использования другой версии следует явно указать её:
 
 ```shell
-docker run --pull always git.axenov.dev/iptv/iptvc:v1.0.6 КОМАНДА [АРГУМЕНТЫ]
+docker run --pull always --name iptvc git.axenov.dev/iptv/iptvc:v1.0.6 КОМАНДА [АРГУМЕНТЫ]
 ```
 
 ## Построение собственного образа
@@ -51,7 +51,7 @@ GOOS=darwin GOARCH=arm64 ./build-docker-image.sh [<версия>]
 Запуск:
 
 ```
-docker run --pull always iptvc:[latest|<версия>] КОМАНДА [АРГУМЕНТЫ]
+docker run --pull always --name iptvc git.axenov.dev/iptv/iptvc КОМАНДА [АРГУМЕНТЫ]
 ```
 
 ## Использование образа в Docker compose