Git repositories
****************

Multiple Git repositories can be imported. The XML syntax is:

.. sourcecode:: xml

  <project>
    <services>
      <service shortname="plugin_git" enabled="true" />
      ...
    </services>

    ...

    <git>
        <ugroups-admin>
            <ugroup>Contributors</ugroup>
            ...
        </ugroups-admin>
        <jenkins-servers-admin>
            <jenkins-server url="https://example.com/jenkins">
            ...
        </jenkins-servers-admin>
        <repository bundle-path="tuleap_dev_bundle" name="dev/tuleap" description="Development git repository for tuleap">
            <read>
                <ugroup>project_members</ugroup>
                ...
            </read>
            <write>
                <ugroup>Contributors</ugroup>
                ...
            </write>
            <wplus>
                <ugroup>project_admins</ugroup>
                ...
            </wplus>
        </repository>
        <repository bundle-path="tuleap_stable_bundle" name="stable/tuleap" description="Frozen git repository for tuleap, contains only tags.">
            ...
        </repository>
      ...

    </git>
    ...
  </project>

- A single ``<git/>`` tag containing:

- An optional  ``<ugroups-admin>`` tag containing:
- One or more ``<ugroup>`` containing the ugroup name. Note that the project administrators
  ugroup will always be part of the git administrators.

- An optional  ``<jenkins-servers-admin>`` tag containing:
- One or more ``<jenkins-server>`` containing the jenkins server URL name.

.. attention::

  This tag needs that the plugin ``hudson_git`` is installed and available.

- One or more ``<repository>`` tag containing:
- The attribute ``bundle-path`` which references a bundle file generated by
  ``git bundle create <name_of_bundle> --all``
- The attribute ``name`` to specify the name of the repository. Note that it accepts a "path" notation
  (see the repository list in the git plugin)
- The attribute ``description`` containing the description of the repository
- The tag ``<read|write|wplus>`` containing one or multiple ``<ugroup>`` tags. It allows to give the
  different permissions of the repository to the given repository. The ``<ugroup>`` tag must contain only
  one ugroup name.

.. attention::

  Git service does not export forked repositories.

Another synthax exists for the git XML import:

.. sourcecode:: xml

  <project>
    <services>
      <service shortname="plugin_git" enabled="true" />
      ...
    </services>

    ...

    <git>
        <ugroups-admin>
            <ugroup>Contributors</ugroup>
            ...
        </ugroups-admin>
        <repository bundle-path="tuleap_dev_bundle" name="dev/tuleap" description="Development git repository for tuleap">
            <permissions>
                <read>
                    <ugroup>project_members</ugroup>
                    ...
                </read>
                <write>
                    <ugroup>Contributors</ugroup>
                    ...
                </write>
                <wplus>
                    <ugroup>project_admins</ugroup>
                    ...
                </wplus>
                <fine_grained enabled="1" use_regexp="1">
                    <pattern value="*" type="branch">
                        <write>
                            <ugroup>Contributors</ugroup>
                            ...
                        </write>
                        <wplus>
                            <ugroup>project_admins</ugroup>
                            ...
                        </wplus>
                    </pattern>
                    <pattern value="*" type="tag">
                        <write>
                            <ugroup>Contributors</ugroup>
                            ...
                        </write>
                        <wplus>
                            <ugroup>project_admins</ugroup>
                            ...
                        </wplus>
                    </pattern>
                </fine_grained>
            </permissions>
        </repository>
        <repository bundle-path="tuleap_stable_bundle" name="stable/tuleap" description="Frozen git repository for tuleap, contains only tags.">
            ...
        </repository>
      ...

    </git>
    ...
  </project>

The big change is in the ``<repository>`` tag:

- The tag ``<permissions>`` containing ``<read|write|wplus>`` and an optional tag named ``<fine_grained>``
- The tag ``<read|write|wplus>`` containing one or multiple ``<ugroup>`` tags. It allows to give the
  different permissions of the repository to the given repository. The ``<ugroup>`` tag must contain only
  one ugroup name.

- The tag ``<fine_grained>`` containing one or multiple ``<pattern>`` tag.
- The attribute ``enabled`` which defines if this permission option is used for the repository or not
- The attribute ``use_regexp`` which defines if patterns with regexp are authorized or not

- The tag ``<pattern>`` containing ``<write|wplus>`` tags.
- The attribute ``value`` which defines the gitolite path checked by the pattern
- The attribute ``type`` which defines if this permission is a branch or a tag permission. The possible values are ``tag`` and ``branch``