Updates to reviewer comments

development
Scott Crossen 4 years ago
parent 94dcceb7b9
commit e894befd87

@ -1,6 +1,6 @@
# Tips for deploying Matrix on a Budget # Dynamic DNS
## Dynamic DNS ## Setup
Most cloud providers / ISPs will charge you extra for a static IP address. If you're Most cloud providers / ISPs will charge you extra for a static IP address. If you're
not hosting a highly reliable homeserver you can workaround this via dynamic DNS. To not hosting a highly reliable homeserver you can workaround this via dynamic DNS. To
@ -9,13 +9,14 @@ google domains, this process is described [here](https://support.google.com/doma
After you've gotten the proper credentials you can add the following config to your inventory/host_vars/matrix.DOMAIN/vars.yml: After you've gotten the proper credentials you can add the following config to your inventory/host_vars/matrix.DOMAIN/vars.yml:
``` ```
matrix_dynamic_dns_username: XXXXXXXXXXXXXXXX matrix_dynamic_dns_domain_configurations: |
matrix_dynamic_dns_password: XXXXXXXXXXXXXXXX {{
matrix_dynamic_dns_provider: 'domains.google.com' [{'provider': 'domains.google.com', 'protocol': 'dyndn2', 'username': 'XXXXXXXXXXXXXXXX', 'password': 'XXXXXXXXXXXXXXXX', 'domain': matrix_domain}]
}}
``` ```
## Additional Reading ## Additional Reading
Additional resources: Additional resources:
- https://matrix.org/docs/guides/free-small-matrix-server - https://matrix.org/docs/guides/free-small-matrix-server

@ -33,7 +33,7 @@ When you're done with all the configuration you'd like to do, continue with [Ins
- [Setting up the Jitsi video-conferencing platform](configuring-playbook-jitsi.md) (optional) - [Setting up the Jitsi video-conferencing platform](configuring-playbook-jitsi.md) (optional)
- [Setting up budget builds or resource-constrained builds](configuring-playbook-budget-builds.md) (optional) - [Setting Dynamic DNS](configuring-playbook-dynamic-dns.md) (optional)
### Core service adjustments ### Core service adjustments

@ -619,6 +619,23 @@ matrix_dimension_homeserver_federationUrl: "http://matrix-synapse:{{ 8048 if mat
###################################################################### ######################################################################
######################################################################
#
# matrix-dynamic-dns
#
######################################################################
matrix_dynamic_dns_domain_configurations: []
######################################################################
#
# /matrix-dynamic-dns
#
######################################################################
###################################################################### ######################################################################
# #
# matrix-email2matrix # matrix-email2matrix

@ -1,11 +1,11 @@
# Whether dynamic dns is enabled # Whether dynamic dns is enabled
matrix_dynamic_dns_enabled: false matrix_dynamic_dns_enabled: "{{ matrix_dynamic_dns_domain_configurations is defined }}"
# The dynamic dns daemon interval # The dynamic dns daemon interval
matrix_dynamic_dns_daemon_interval: '300' matrix_dynamic_dns_daemon_interval: '300'
# The docker container to use when in mode # The docker container to use when in mode
matrix_dynamic_dns_docker_image: 'linuxserver/ddclient' matrix_dynamic_dns_docker_image: 'linuxserver/ddclient:v3.9.1-ls45'
# The image to force pull # The image to force pull
matrix_dynamic_dns_docker_image_force_pull: "{{ matrix_dynamic_dns_docker_image.endswith(':latest') }}" matrix_dynamic_dns_docker_image_force_pull: "{{ matrix_dynamic_dns_docker_image.endswith(':latest') }}"
@ -28,13 +28,5 @@ matrix_dynamic_dns_config_path: "{{ matrix_dynamic_dns_base_path }}/config"
matrix_dynamic_dns_docker_src_files_path: "{{ matrix_dynamic_dns_base_path }}/docker-src" matrix_dynamic_dns_docker_src_files_path: "{{ matrix_dynamic_dns_base_path }}/docker-src"
# Config options # Config options
matrix_dynamic_dns_additional_configuration_blocks: []
matrix_dynamic_dns_use: "web" matrix_dynamic_dns_use: "web"
matrix_dynamic_dns_static: false
matrix_dynamic_dns_custom: false
matrix_dynamic_dns_zone: ""
matrix_dynamic_dns_ttl: ""
matrix_dynamic_dns_mx: ""
matrix_dynamic_dns_wildcard: false
matrix_dynamic_dns_protocol: 'dyndns2'
matrix_dynamic_dns_provider: 'domains.google.com'
matrix_dynamic_dns_domain: '{{ matrix_domain }}'

@ -12,7 +12,7 @@
file: file:
path: "{{ item.path }}" path: "{{ item.path }}"
state: directory state: directory
mode: 0750 mode: 0751
owner: "{{ matrix_user_username }}" owner: "{{ matrix_user_username }}"
group: "{{ matrix_user_groupname }}" group: "{{ matrix_user_groupname }}"
with_items: with_items:

@ -1,10 +1,10 @@
--- ---
- name: Fail if required settings not defined - name: Fail if required settings not defined in configuration blocks
fail: fail:
msg: >- msg: >-
You need to define a required configuration setting (`{{ item }}`). You need to define a required configuration setting (`{{ item }}`).
when: "vars[item] == ''" when: "'domain' not in configuration == '' or 'provider' not in configuration == '' or 'protocol' not in configuration == ''"
with_items: with_items: "{{ matrix_dynamic_dns_domain_configurations }}"
- "matrix_dynamic_dns_domain" loop_control:
- "matrix_dynamic_dns_provider" loop_var: configuration

@ -3,14 +3,24 @@ syslog=no
pid=/var/run/ddclient/ddclient.pid pid=/var/run/ddclient/ddclient.pid
ssl=yes ssl=yes
use={{ matrix_dynamic_dns_use }} use={{ matrix_dynamic_dns_use }}
protocol={{ matrix_dynamic_dns_protocol }}
server={{ matrix_dynamic_dns_provider }} {% if matrix_dynamic_dns_username %} {% for dynamic_dns_domain_configuration in matrix_dynamic_dns_domain_configurations %}
login='{{ matrix_dynamic_dns_username }}' {% endif %} {% if matrix_dynamic_dns_username %} protocol={{ dynamic_dns_domain_configuration.protocol }}
password='{{ matrix_dynamic_dns_password }}' {% endif %} {% if matrix_dynamic_dns_static %} server={{ dynamic_dns_domain_configuration.provider }} {% if 'username' in dynamic_dns_domain_configuration %}
static=yes {% endif %} {% if matrix_dynamic_dns_custom %} login='{{ dynamic_dns_domain_configuration.username }}' {% endif %} {% if 'password' in dynamic_dns_domain_configuration %}
custom=yes {% endif %} {% if matrix_dynamic_dns_zone %} password='{{ dynamic_dns_domain_configuration.password }}' {% endif %} {% if 'static' in dynamic_dns_domain_configuration %}
zone={{ matrix_dynamic_dns_zone }} {% endif %} {% if matrix_dynamic_dns_ttl %} static=yes {% endif %} {% if 'custom' in dynamic_dns_domain_configuration %}
ttl={{ matrix_dynamic_dns_ttl }} {% endif %} {% if matrix_dynamic_dns_mx %} custom=yes {% endif %} {% if 'zone' in dynamic_dns_domain_configuration %}
mx={{ matrix_dynamic_dns_mx }} {% endif %} {% if matrix_dynamic_dns_wildcard %} zone={{ dynamic_dns_domain_configuration.zone }} {% endif %} {% if 'ttl' in dynamic_dns_domain_configuration %}
ttl={{ dynamic_dns_domain_configuration.ttl }} {% endif %} {% if 'mx' in dynamic_dns_domain_configuration %}
mx={{ dynamic_dns_domain_configuration.mx }} {% endif %} {% if 'wildcard' in dynamic_dns_domain_configuration %}
wildcard=yes {% endif %} wildcard=yes {% endif %}
{{ matrix_dynamic_dns_domain }} {{ dynamic_dns_domain_configuration.domain }}
{% endfor %}
{% for matrix_dynamic_dns_additional_configuration in matrix_dynamic_dns_additional_configuration_blocks %}
{{ matrix_dynamic_dns_additional_configuration }}
{% endfor %}

@ -15,12 +15,9 @@ ExecStartPre=-{{ matrix_host_command_docker }} kill matrix-dynamic-dns
ExecStartPre=-{{ matrix_host_command_docker }} rm matrix-dynamic-dns ExecStartPre=-{{ matrix_host_command_docker }} rm matrix-dynamic-dns
ExecStart={{ matrix_host_command_docker }} run --rm --name matrix-dynamic-dns \ ExecStart={{ matrix_host_command_docker }} run --rm --name matrix-dynamic-dns \
--log-driver=none \ --log-driver=none \
--user={{ matrix_user_uid }}:{{ matrix_user_gid }} \
--cap-drop=ALL \
--network={{ matrix_docker_network }} \ --network={{ matrix_docker_network }} \
-e PUID={{ matrix_user_uid }} \ -e PUID={{ matrix_user_uid }} \
-e PGID={{ matrix_user_gid }} \ -e PGID={{ matrix_user_gid }} \
-e CONFIG_PATH=/config/config.yaml \
-v {{ matrix_dynamic_dns_config_path }}:/config:z \ -v {{ matrix_dynamic_dns_config_path }}:/config:z \
{% for arg in matrix_dynamic_dns_container_extra_arguments %} {% for arg in matrix_dynamic_dns_container_extra_arguments %}
{{ arg }} \ {{ arg }} \

@ -12,6 +12,18 @@
- set_fact: - set_fact:
domain_name_needs_cert: "{{ not domain_name_certificate_path_stat.stat.exists }}" domain_name_needs_cert: "{{ not domain_name_certificate_path_stat.stat.exists }}"
- name: Ensure dynamic dns has ran
service:
name: "dynamic-dns"
state: started
register: dynamic_dns_service_update
when: "domain_name_needs_cert|bool and matrix_dynamic_dns_enabled|bool"
- name: Sleep for 60 seconds so that DNS records can be updated
wait_for:
timeout: 60
when: dynamic_dns_service_update.changed
# This will fail if there is something running on port 80 (like matrix-nginx-proxy). # This will fail if there is something running on port 80 (like matrix-nginx-proxy).
# We suppress the error, as we'll try another method below. # We suppress the error, as we'll try another method below.
- name: Attempt initial SSL certificate retrieval with standalone authenticator (directly) - name: Attempt initial SSL certificate retrieval with standalone authenticator (directly)

Loading…
Cancel
Save