.. include:: /Includes.rst.txt
.. index:: Ddev

Vorbereitungen
==============

Wir nutzen verschiedene Systeme zur Entwicklung der DRK-KV-Musterstadt-Vorlage.

Für die lokale Entwicklung nutzen wir DDEV von DRUD.
Eine freie Umgebung, mit der relativ einfach Docker Images erzeugt werden können.
Diese Images werden dann genutzt um die lokale Entwicklungsumgebung zu starten.

Dies ist die einzige unterstützte Form, an der Entwicklung dieses Paketes teilzunehmen.

Installation von DDEV
---------------------

Zur Installation von DDEV gibt es diverse Tutorials in der Dokumentation von DDEV:

* https://ddev.readthedocs.io/en/stable/#installation

.. code-block:: bash

    # Mac
    brew tap drud/ddev && brew install ddev

    # install chocolatey and then
    choco install ddev

    # linux (brewtap
    brew tap drud/ddev && brew install ddev

    # linux standalone
    curl -L https://raw.githubusercontent.com/drud/ddev/master/scripts/install_ddev.sh | bash

Da DDEV auch SSL lokal verfügbar macht, ist es auf Linux und Mac oft nötig noch das folgende Script auszuführen.
Damit wird eine lokale Certificate Authority erstellt.

.. code-block:: bash

    mkcert -install

Auch dazu gibt es in der Dokumentation von DDEV ausführliche Hinweise.

Start der Entwicklungsumgebung
------------------------------

DDEV wird komplett aus dem Terminal bedient. Im Wurzelverzeichnis des Projektes wird der folgende Befehl ausgeführt um
die lokale Entwicklungsumgebung zu starten:

.. code-block:: bash

    ddev start

Mit nur einem Befehl kann auch die komplette KV Musterstadt Datenbank inklusive aller Dateien importiert werden.
Der Download kann einige Minuten dauern.

.. code-block:: bash

    ddev pull

Import DataDump
---------------

* https://www.drk-intern.de/fileadmin/musterseiten/master_dump.sql.gz
* https://www.drk-intern.de/fileadmin/musterseiten/master_dump.tgz

.. code:: bash

  curl -O https://www.drk-intern.de/fileadmin/musterseiten/master_dump.sql.gz
  ddev import-db --src master_dump.sql.gz
  rm master_dump.sql.gz

  curl -O https://www.drk-intern.de/fileadmin/musterseiten/master_dump.tgz
  ddev import-files --src master_dump.tgz
  rm master_dump.tgz