From f539a42024a4ef018ee95d26c865248a1e8ac335 Mon Sep 17 00:00:00 2001
From: Stefan Haun <tux@netz39.de>
Date: Thu, 20 Jan 2022 10:03:24 +0100
Subject: [PATCH 01/10] Add a docker registry
---
tau.yml | 44 ++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 44 insertions(+)
diff --git a/tau.yml b/tau.yml
index 60bb1f7..5652e28 100644
--- a/tau.yml
+++ b/tau.yml
@@ -5,6 +5,9 @@
vars:
ansible_python_interpreter: /usr/bin/python3
+ docker_registry_port: 5000 # this is the reg standard port
+ docker_registry_domain: "docker-registry.n39.eu"
+
roles:
- role: docker_setup
- role: apache
@@ -31,6 +34,8 @@
deploy_challenge_hook: "/bin/systemctl restart apache2"
- name: "mysql.adm.netz39.de"
deploy_challenge_hook: "/bin/systemctl restart apache2"
+ - name: "{{ docker_registry_domain }}"
+ deploy_challenge_hook: "/bin/systemctl restart apache2"
- name: Setup forward site reservierung.netz39.de
include_role:
@@ -68,3 +73,42 @@
vars:
site_name: mysql.adm.netz39.de
proxy_port: 9001
+
+
+ - name: Check if Docker Registry auth dir exists
+ ansible.builtin.stat:
+ path: "/srv/docker/registry/auth"
+ register: docker_dir
+ - name: Fail if docker registry data dir does not exist
+ ansible.builtin.fail:
+ msg: "Docker Registry auth dir is missing, please restore from the backup!"
+ when: not docker_dir.stat.exists
+ - name: Ensure the Docker Registry data directory exists
+ # This may not be part of the backup
+ file:
+ path: "/srv/docker/registry/data"
+
+ - name: Setup Docker Registry Container
+ docker_container:
+ name: registry
+ image: "registry:2"
+ pull: true
+ state: started
+ restart_policy: unless-stopped
+ detach: yes
+ ports:
+ - 127.0.0.1:{{ docker_registry_port }}:{{ docker_registry_port }}
+ env:
+ REGISTRY_HTTP_HOST: "https://{{ docker_registry_domain }}"
+ REGISTRY_AUTH_HTPASSWD_REALM: "Netz39 Docker Registry"
+ REGISTRY_AUTH_HTPASSWD_PATH: "/auth/htpasswd"
+ volumes:
+ - "/srv/docker/registry/data:/var/lib/registry:rw"
+ - "/srv/docker/registry/auth:/auth:rw"
+
+ - name: Setup proxy site for the Docker Registry
+ include_role:
+ name: setup-http-site-proxy
+ vars:
+ site_name: "{{ docker_registry_domain }}"
+ proxy_port: "{{ docker_registry_port }}"
From 00a647036e5f951682ab51691f98298be67c4ef2 Mon Sep 17 00:00:00 2001
From: Stefan Haun <tux@netz39.de>
Date: Thu, 20 Jan 2022 12:11:54 +0100
Subject: [PATCH 02/10] Switch domain to docker.n39.eu
---
tau.yml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/tau.yml b/tau.yml
index 5652e28..10a68a6 100644
--- a/tau.yml
+++ b/tau.yml
@@ -6,7 +6,7 @@
ansible_python_interpreter: /usr/bin/python3
docker_registry_port: 5000 # this is the reg standard port
- docker_registry_domain: "docker-registry.n39.eu"
+ docker_registry_domain: "docker.n39.eu"
roles:
- role: docker_setup
From 48a4e9e62eb544ee4a39aed42fd6e04fa5eb37c7 Mon Sep 17 00:00:00 2001
From: Maximilian Deubel <maximilian.deubel@gmail.com>
Date: Wed, 5 Jan 2022 21:19:49 +0100
Subject: [PATCH 03/10] add unifi controller role and playbook
---
unicorn.yml | 25 +++++++++++++++++++++++--
1 file changed, 23 insertions(+), 2 deletions(-)
diff --git a/unicorn.yml b/unicorn.yml
index 5d94c81..cf990d8 100644
--- a/unicorn.yml
+++ b/unicorn.yml
@@ -1,11 +1,32 @@
---
+# this is for a dedicated vm just hosting the unifi controller.
- hosts: unicorn.n39.eu
become: true
-
vars:
ansible_python_interpreter: /usr/bin/python3
-
roles:
- role: docker_setup
vars:
docker_data_root: "/srv/docker"
+ tasks:
+ - name: Setup the docker container for unifi-controller
+ docker_container:
+ name: unifi-controller
+ image: "jacobalberty/unifi:v6.5.55"
+ state: started
+ restart_policy: unless-stopped
+ container_default_behavior: no_defaults
+ env:
+ TZ: "Europe/Berlin"
+ # These fixed ports are needed.
+ # https://help.ui.com/hc/en-us/articles/218506997-UniFi-Ports-Used
+ ports:
+ - "8080:8080/tcp" # Device command/control
+ - "8443:8443/tcp" # Web interface + API
+ - "8843:8843/tcp" # HTTPS portal
+ - "8880:8880/tcp" # HTTP portal
+ - "3478:3478/udp" # STUN service
+ - "6789:6789/tcp" # Speed Test (unifi5 only)
+ volumes:
+ - "/srv/data/unifi-controller/data:/unifi/data"
+ - "/srv/data/unifi-controller/log:/unifi/log"
From 71e031cdc6ee681c39d58f8a5b7a2cd633ba1e63 Mon Sep 17 00:00:00 2001
From: Stefan Haun <tux@netz39.de>
Date: Sat, 29 Jan 2022 12:41:34 +0100
Subject: [PATCH 04/10] Fix creation of directory for docker registry
---
tau.yml | 1 +
1 file changed, 1 insertion(+)
diff --git a/tau.yml b/tau.yml
index 10a68a6..74f6e1d 100644
--- a/tau.yml
+++ b/tau.yml
@@ -87,6 +87,7 @@
# This may not be part of the backup
file:
path: "/srv/docker/registry/data"
+ state: directory
- name: Setup Docker Registry Container
docker_container:
From b6a05b8c8cfedd7cc61ba0420302987bb0119722 Mon Sep 17 00:00:00 2001
From: Stefan Haun <tux@netz39.de>
Date: Sat, 29 Jan 2022 19:34:16 +0100
Subject: [PATCH 05/10] Downgrade Openhab to 2.5.11
Openhab 3.1 does not work for us. The chosen version has been
detemined by analysing the (scarce) log entries. It seems that
migration beyond this point breaks the configuration and leads
to an incomplete setup.
---
pottwal.yml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/pottwal.yml b/pottwal.yml
index 41a96e7..90d910b 100644
--- a/pottwal.yml
+++ b/pottwal.yml
@@ -8,7 +8,7 @@
mosquitto_image: eclipse-mosquitto:1.6
mosquitto_data: /srv/data/mosquitto
- openhab_image: openhab/openhab:3.1.0
+ openhab_image: openhab/openhab:2.5.11
openhab_data: /srv/data/openhab
openhab_host_port: 8081
openhab_configuration_source: https://github.com/netz39/n39-openhab.git
From b1b338272891a9186f516795eafc6058a610236c Mon Sep 17 00:00:00 2001
From: Alexander Dahl <alex@netz39.de>
Date: Sun, 30 Jan 2022 11:42:48 +0100
Subject: [PATCH 06/10] Revert "Fix YAML format issues"
This reverts commit babeef822682d75939ec91039afee7d8e92efb7e.
Instead of fixing the indentation of the recently introduced gitea
stuff, the indentation of the old stuff was changed.
---
pottwal.yml | 274 ++++++++++++++++++++++++++--------------------------
1 file changed, 137 insertions(+), 137 deletions(-)
diff --git a/pottwal.yml b/pottwal.yml
index 90d910b..fe08604 100644
--- a/pottwal.yml
+++ b/pottwal.yml
@@ -71,156 +71,156 @@
site_name: "gitea.n39.eu"
proxy_port: "{{ gitea_host_port }}"
- - name: Ensure apt-cacher container is running
- docker_container:
- name: apt_cacher_ng
- image: "mrtux/apt-cacher-ng"
- pull: true
- state: started
- restart_policy: unless-stopped
- detach: yes
- ports:
- - 3142:3142
+ - name: Ensure apt-cacher container is running
+ docker_container:
+ name: apt_cacher_ng
+ image: "mrtux/apt-cacher-ng"
+ pull: true
+ state: started
+ restart_policy: unless-stopped
+ detach: yes
+ ports:
+ - 3142:3142
- - name: Ensure the mosquitto directories exist
- file:
- path: "{{ item }}"
- state: directory
- with_items:
- - "{{ mosquitto_data }}/config"
- - "{{ mosquitto_data }}/data"
- - "{{ mosquitto_data }}/log"
+ - name: Ensure the mosquitto directories exist
+ file:
+ path: "{{ item }}"
+ state: directory
+ with_items:
+ - "{{ mosquitto_data }}/config"
+ - "{{ mosquitto_data }}/data"
+ - "{{ mosquitto_data }}/log"
- - name: Make sure mosquitto config is there
- template:
- src: "templates/mosquitto.conf.j2"
- dest: "{{ mosquitto_data }}/config/mosquitto.conf"
- notify: restart_mosquitto
+ - name: Make sure mosquitto config is there
+ template:
+ src: "templates/mosquitto.conf.j2"
+ dest: "{{ mosquitto_data }}/config/mosquitto.conf"
+ notify: restart_mosquitto
- - name: Ensure mosquitto is running
- docker_container:
- name: mosquitto
- image: "{{ mosquitto_image }}"
- pull: true
- state: started
- ports:
- - 1883:1883
- - 9001:9001
- volumes:
- - "{{ mosquitto_data }}/config:/mosquitto/config"
- - "{{ mosquitto_data }}/data:/mosquitto/data"
- - "{{ mosquitto_data }}/log:/mosquitto/log"
- detach: yes
- keep_volumes: yes
- restart_policy: unless-stopped
+ - name: Ensure mosquitto is running
+ docker_container:
+ name: mosquitto
+ image: "{{ mosquitto_image }}"
+ pull: true
+ state: started
+ ports:
+ - 1883:1883
+ - 9001:9001
+ volumes:
+ - "{{ mosquitto_data }}/config:/mosquitto/config"
+ - "{{ mosquitto_data }}/data:/mosquitto/data"
+ - "{{ mosquitto_data }}/log:/mosquitto/log"
+ detach: yes
+ keep_volumes: yes
+ restart_policy: unless-stopped
- - name: Ensure the openhab directories exist
- file:
- path: "{{ item }}"
- state: directory
- with_items:
- - "{{ openhab_data }}/addons"
- - "{{ openhab_data }}/conf"
- - "{{ openhab_data }}/userdata"
+ - name: Ensure the openhab directories exist
+ file:
+ path: "{{ item }}"
+ state: directory
+ with_items:
+ - "{{ openhab_data }}/addons"
+ - "{{ openhab_data }}/conf"
+ - "{{ openhab_data }}/userdata"
- - name: Clone or update configuration
- git:
- repo: "{{ openhab_configuration_source }}"
- version: "{{ openhab_configuration_version }}"
- dest: "{{ openhab_data }}/conf"
- clone: yes
- update: yes
+ - name: Clone or update configuration
+ git:
+ repo: "{{ openhab_configuration_source }}"
+ version: "{{ openhab_configuration_version }}"
+ dest: "{{ openhab_data }}/conf"
+ clone: yes
+ update: yes
- - name: ensure openhab is up and running
- docker_container:
- name: openhab
- image: "{{ openhab_image }}"
- pull: true
- state: started
- detach: yes
- interactive: yes
- tty: yes
- ports:
- - "{{ openhab_host_port }}:8080"
- volumes:
- - /etc/localtime:/etc/localtime:ro
- - /etc/timezone:/etc/timezone:ro
- - "{{ openhab_data }}/addons:/openhab/addons:rw"
- - "{{ openhab_data }}/conf:/openhab/conf:rw"
- - "{{ openhab_data }}/userdata:/openhab/userdata:rw"
- keep_volumes: yes
- restart_policy: unless-stopped
- env: EXTRA_JAVA_OPTS="-Duser.timezone=Europe/Berlin"
+ - name: ensure openhab is up and running
+ docker_container:
+ name: openhab
+ image: "{{ openhab_image }}"
+ pull: true
+ state: started
+ detach: yes
+ interactive: yes
+ tty: yes
+ ports:
+ - "{{ openhab_host_port }}:8080"
+ volumes:
+ - /etc/localtime:/etc/localtime:ro
+ - /etc/timezone:/etc/timezone:ro
+ - "{{ openhab_data }}/addons:/openhab/addons:rw"
+ - "{{ openhab_data }}/conf:/openhab/conf:rw"
+ - "{{ openhab_data }}/userdata:/openhab/userdata:rw"
+ keep_volumes: yes
+ restart_policy: unless-stopped
+ env: EXTRA_JAVA_OPTS="-Duser.timezone=Europe/Berlin"
- - name: Setup proxy site openhab.n39.eu
- include_role:
- name: setup-http-site-proxy
- vars:
- site_name: openhab.n39.eu
- proxy_port: "{{ openhab_host_port }}"
+ - name: Setup proxy site openhab.n39.eu
+ include_role:
+ name: setup-http-site-proxy
+ vars:
+ site_name: openhab.n39.eu
+ proxy_port: "{{ openhab_host_port }}"
- - name: Ensure container for URI tools is running
- docker_container:
- name: uritools
- image: mrtux/clean_uri
- pull: true
- state: started
- detach: yes
- ports:
- - "{{ uritools_host_port }}:8080"
- restart_policy: unless-stopped
+ - name: Ensure container for URI tools is running
+ docker_container:
+ name: uritools
+ image: mrtux/clean_uri
+ pull: true
+ state: started
+ detach: yes
+ ports:
+ - "{{ uritools_host_port }}:8080"
+ restart_policy: unless-stopped
- - name: Setup proxy site uritools.n39.eu
- include_role:
- name: setup-http-site-proxy
- vars:
- site_name: uritools.n39.eu
- proxy_port: "{{ uritools_host_port }}"
+ - name: Setup proxy site uritools.n39.eu
+ include_role:
+ name: setup-http-site-proxy
+ vars:
+ site_name: uritools.n39.eu
+ proxy_port: "{{ uritools_host_port }}"
- - name: Ensure container for entities validation service is running
- docker_container:
- name: entities_validation_svc
- image: netz39/entities_validation_svc:v1.0.0
- pull: true
- state: started
- detach: yes
- ports:
- - "{{ entities_validation_svc_host_port }}:8080"
- restart_policy: unless-stopped
+ - name: Ensure container for entities validation service is running
+ docker_container:
+ name: entities_validation_svc
+ image: netz39/entities_validation_svc:v1.0.0
+ pull: true
+ state: started
+ detach: yes
+ ports:
+ - "{{ entities_validation_svc_host_port }}:8080"
+ restart_policy: unless-stopped
- - name: Setup proxy site entities-validation.svc.n39.eu
- include_role:
- name: setup-http-site-proxy
- vars:
- site_name: entities-validation.svc.n39.eu
- proxy_port: "{{ entities_validation_svc_host_port }}"
+ - name: Setup proxy site entities-validation.svc.n39.eu
+ include_role:
+ name: setup-http-site-proxy
+ vars:
+ site_name: entities-validation.svc.n39.eu
+ proxy_port: "{{ entities_validation_svc_host_port }}"
- - name: Ensure container for shlink is running
- docker_container:
- name: shlink
- image: shlinkio/shlink:2.6.2
- pull: true
- state: started
- detach: yes
- ports:
- - "{{ shlink_host_port }}:8080"
- restart_policy: unless-stopped
- env:
- SHORT_DOMAIN_HOST: "{{ shlink_domain_name }}"
- SHORT_DOMAIN_SCHEMA: https
- GEOLITE_LICENSE_KEY: "{{ shlink_geolite_license_key }}"
+ - name: Ensure container for shlink is running
+ docker_container:
+ name: shlink
+ image: shlinkio/shlink:2.6.2
+ pull: true
+ state: started
+ detach: yes
+ ports:
+ - "{{ shlink_host_port }}:8080"
+ restart_policy: unless-stopped
+ env:
+ SHORT_DOMAIN_HOST: "{{ shlink_domain_name }}"
+ SHORT_DOMAIN_SCHEMA: https
+ GEOLITE_LICENSE_KEY: "{{ shlink_geolite_license_key }}"
- - name: Setup proxy site {{ shlink_domain_name }}
- include_role:
- name: setup-http-site-proxy
- vars:
- site_name: "{{ shlink_domain_name }}"
- proxy_port: "{{ shlink_host_port }}"
+ - name: Setup proxy site {{ shlink_domain_name }}
+ include_role:
+ name: setup-http-site-proxy
+ vars:
+ site_name: "{{ shlink_domain_name }}"
+ proxy_port: "{{ shlink_host_port }}"
handlers:
- - name: restart mosquitto
- docker_container:
- name: mosquitto
- state: started
- restart: yes
+ - name: restart mosquitto
+ docker_container:
+ name: mosquitto
+ state: started
+ restart: yes
From be09ef57f61059ad6f79265aa6d8fedae7597af7 Mon Sep 17 00:00:00 2001
From: Alexander Dahl <alex@netz39.de>
Date: Sun, 30 Jan 2022 11:48:09 +0100
Subject: [PATCH 07/10] pottwal: Fix indentation
Please yamllint.
Fixes: 3aced1fe4623 ("Install gitea via ansible")
---
pottwal.yml | 80 ++++++++++++++++++++++++++---------------------------
1 file changed, 40 insertions(+), 40 deletions(-)
diff --git a/pottwal.yml b/pottwal.yml
index fe08604..390446d 100644
--- a/pottwal.yml
+++ b/pottwal.yml
@@ -28,48 +28,48 @@
tasks:
- - name: Check if gitea data dir exists
- ansible.builtin.stat:
- path: "/srv/data/gitea"
- register: gitea_dir
- - name: Fail if gitea data dir does not exist
- ansible.builtin.fail:
- msg: "Gitea data dir is missing, please restore from the backup!"
- when: not gitea_dir.stat.exists
+ - name: Check if gitea data dir exists
+ ansible.builtin.stat:
+ path: "/srv/data/gitea"
+ register: gitea_dir
+ - name: Fail if gitea data dir does not exist
+ ansible.builtin.fail:
+ msg: "Gitea data dir is missing, please restore from the backup!"
+ when: not gitea_dir.stat.exists
- # If port 2222 is changed here, it must also be adapted
- # in the gitea config file (see application volume)!!
- - name: Setup the docker container for gitea
- docker_container:
- name: gitea
- image: "gitea/gitea:1.15.10"
- pull: true
- state: started
- restart_policy: unless-stopped
- detach: yes
- ports:
-# - 127.0.0.1:{{ gitea_host_port }}:3000
- - "{{ gitea_host_port }}:3000"
- - 2222:2222
- env:
- APP_NAME="Netz39 Gitea"
- RUN_MODE="prod"
- SSH_DOMAIN="gitea.n39.eu"
- SSH_PORT="2222"
- SSH_START_SERVER="false"
- ROOT_URL="https://gitea.n39.eu"
- DISABLE_REGISTRATION="true"
- USER_UID=1000
- USER_GID=1000
- volumes:
- - "/srv/data/gitea:/data:rw"
+ # If port 2222 is changed here, it must also be adapted
+ # in the gitea config file (see application volume)!!
+ - name: Setup the docker container for gitea
+ docker_container:
+ name: gitea
+ image: "gitea/gitea:1.15.10"
+ pull: true
+ state: started
+ restart_policy: unless-stopped
+ detach: yes
+ ports:
+# - 127.0.0.1:{{ gitea_host_port }}:3000
+ - "{{ gitea_host_port }}:3000"
+ - 2222:2222
+ env:
+ APP_NAME="Netz39 Gitea"
+ RUN_MODE="prod"
+ SSH_DOMAIN="gitea.n39.eu"
+ SSH_PORT="2222"
+ SSH_START_SERVER="false"
+ ROOT_URL="https://gitea.n39.eu"
+ DISABLE_REGISTRATION="true"
+ USER_UID=1000
+ USER_GID=1000
+ volumes:
+ - "/srv/data/gitea:/data:rw"
- - name: Setup proxy site gitea.n39.eu
- include_role:
- name: setup-http-site-proxy
- vars:
- site_name: "gitea.n39.eu"
- proxy_port: "{{ gitea_host_port }}"
+ - name: Setup proxy site gitea.n39.eu
+ include_role:
+ name: setup-http-site-proxy
+ vars:
+ site_name: "gitea.n39.eu"
+ proxy_port: "{{ gitea_host_port }}"
- name: Ensure apt-cacher container is running
docker_container:
From 65bfb358ddbc724518a5cf970013314aeccd93d3 Mon Sep 17 00:00:00 2001
From: Alexander Dahl <alex@netz39.de>
Date: Sun, 30 Jan 2022 11:48:51 +0100
Subject: [PATCH 08/10] pottwal: Strip trailing whitespace
---
pottwal.yml | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/pottwal.yml b/pottwal.yml
index 390446d..a4b48c2 100644
--- a/pottwal.yml
+++ b/pottwal.yml
@@ -216,8 +216,8 @@
name: setup-http-site-proxy
vars:
site_name: "{{ shlink_domain_name }}"
- proxy_port: "{{ shlink_host_port }}"
-
+ proxy_port: "{{ shlink_host_port }}"
+
handlers:
- name: restart mosquitto
docker_container:
From 53b7815d27d52db9d5aaaad4661d49044ec38bba Mon Sep 17 00:00:00 2001
From: Maximilian Deubel <maximilian.deubel@gmail.com>
Date: Sun, 13 Feb 2022 00:10:01 +0100
Subject: [PATCH 09/10] Add BLE-Keykeeper to platon
---
inventory | 3 +++
main.yml | 3 +++
platon.yml | 9 +++++++++
requirements.yml | 2 ++
4 files changed, 17 insertions(+)
create mode 100644 platon.yml
diff --git a/inventory b/inventory
index fa4f6bb..64feb95 100644
--- a/inventory
+++ b/inventory
@@ -78,3 +78,6 @@ all:
34613761363237633865306332653631323366343232353666343165666664343838
unicorn.n39.eu:
server_admin: "admin+unicorn@netz39.de"
+ platon.n39.eu:
+ server_admin: "admin+platon@netz39.de"
+ ansible_ssh_user: pi
\ No newline at end of file
diff --git a/main.yml b/main.yml
index c725c75..97e6da4 100644
--- a/main.yml
+++ b/main.yml
@@ -42,3 +42,6 @@
- name: Specific setup for host unicorn
import_playbook: unicorn.yml
+
+- name: Platon specific setup
+ import_playbook: platon.yml
\ No newline at end of file
diff --git a/platon.yml b/platon.yml
new file mode 100644
index 0000000..c066509
--- /dev/null
+++ b/platon.yml
@@ -0,0 +1,9 @@
+---
+- hosts: platon.n39.eu
+ become: true
+ vars:
+ ansible_python_interpreter: /usr/bin/python3
+ door_open_command: '/home/pi/netz39_rollladensteuerung/raspberry/doorcontrol/door-open.sh'
+ ble_keykeeper_dir: '/home/pi/netz39_ble_keykeeper'
+ roles:
+ - role: ble-keykeeper-role
\ No newline at end of file
diff --git a/requirements.yml b/requirements.yml
index a608f7f..ba18381 100644
--- a/requirements.yml
+++ b/requirements.yml
@@ -5,3 +5,5 @@
version: 3.0.0
- src: git+https://github.com/24367dfa/ansible-role-dehydrated.git
version: 1.0.2
+- src: git+https://github.com/maz3max/ble-keykeeper-role.git
+ version: v1.0.0
\ No newline at end of file
From 76d25384c61f3430f52e346af3c491d6ff067401 Mon Sep 17 00:00:00 2001
From: Maximilian Deubel <maximilian.deubel@gmail.com>
Date: Wed, 2 Mar 2022 21:04:37 +0100
Subject: [PATCH 10/10] bump ble version
---
requirements.yml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/requirements.yml b/requirements.yml
index ba18381..3641f1f 100644
--- a/requirements.yml
+++ b/requirements.yml
@@ -6,4 +6,4 @@
- src: git+https://github.com/24367dfa/ansible-role-dehydrated.git
version: 1.0.2
- src: git+https://github.com/maz3max/ble-keykeeper-role.git
- version: v1.0.0
\ No newline at end of file
+ version: v1.0.1