Kenniscentrum

Git Server

Git is een open-source gedistribueerd versiebeheersysteem, waarmee u de broncode van software, documenten of elk type bestand snel en efficiënt op een computer kunt onderhouden. Met Git kunt u eenvoudig met verschillende groepen en personen tegelijk samenwerken.

Om een Git-repository aan te maken:

  1. Meld u aan bij DSM met een account met beheerdersrechten.
  2. Ga naar Configuratiescherm > Terminal & SNMP > Terminal en schakel SSH-service in.
  3. Ga naar Configuratiescherm > Gedeelde map en maak een gedeelde map voor Git-repositories aan.
  4. Voer op uw computer de onderstaande opdracht in om via SSH toegang te krijgen tot Synology NAS:
    ssh [Synology NAS gebruikersnaam admin]@[Synology NAS IP-adres of hostnaam] -p [Het poortnummer van SSH]
    Voer bijvoorbeeld in:
    ssh myadminuser@192.168.1.2 -p 22
  5. Voer de onderstaande opdracht in om de huidige map te wijzigen in de gedeelde map die u in stap 3 hebt gemaakt:
    cd /[Volumenaam]/[naam gedeelde map]/
    Voer bijvoorbeeld in:
    cd /volume1/mysharefolder/
  6. Voer de onderstaande opdracht in om een map op uw computer te maken voor de Git-repository:
    mkdir [mapnaam]
  7. Voer de onderstaande opdracht in om de huidige locatie naar de nieuwe map te wijzigen:
    cd [mapnaam]
  8. Voer de onderstaande opdracht in om een kale Git-repository te maken onder de map die u in stap 6 hebt gemaakt:
    git init --bare

Opmerking:

  • Voer bovenstaande opdrachten niet uit met rootmachtiging.

Om gebruikers toe te staan om Git te gebruiken:

  1. Meld u aan bij DSM met een account met beheerdersrechten.
  2. Ga naar Configuratiescherm > Terminal en SNMP > Terminal en schakel SSH-service in zodat gebruikers via SSH toegang kunnen krijgen tot Git-repositories.
  3. Ga naar Configuratiescherm > Gebruiker en groep en maak een gebruiker aan. Verleen Lees/schrijf-rechten aan de gebruiker voor de gedeelde map van de Git-repository.
  4. Ga naar Package Center > Geïnstalleerd en start het pakket Git Server.
  5. Sta de gebruiker toe toegang te krijgen tot repositories via git-shell.

Opmerking:

  • De machtigingen van standaardgebruikers (root, admin en guest) kunnen niet worden gewijzigd.
  • Afgezien van de gebruikersmachtigingenlijst voor Git Server, zouden alle bewerkingen voor Git Server moeten worden uitgevoerd via SSH in plaats van DSM-desktop.
  • Git-gebruikers worden beperkt tot Git-gerelateerde activiteiten met behulp van de shell tool git-shell. Deze aanmeldings-shell wordt toegepast voor Git-gebruikers en garandeert dat accounts alleen voor Git-activiteiten worden gebruikt. Als gevolg hiervan kunnen Git-gebruikers alleen de SSH-verbinding gebruiken om Git-repositories te pushen en te trekken, en hebben ze geen volledige toegang tot DSM.

Git-repositories klonen van DSM naar een lokale directory:

  1. Installeer Git op de computer.
  2. Ga naar de Git-repository op uw Synology NAS. Zorg voor gegarandeerde toegang dat:
    • SSH-service is ingeschakeld.
    • Het gebruikersaccount dat u gebruikt, heeft toestemming voor toegang tot de repository.
    • Het gebruikersaccount dat u gebruikt, heeft de machtiging Lezen/schrijven voor de gedeelde map waarin de repository zich bevindt.
  3. Voer de onderstaande opdracht in om de repository van DSM naar de lokale directory te klonen:
    git clone ssh://[uw gebruikersnaam]@[IP-adres of hostnaam Synology NAS]:[uw repository]
    Voer bijvoorbeeld in:
    git clone ssh://mygituser@192.168.1.2:/volume1/mysharefolder/myrepo1
  4. U kunt de repository openen vanuit de lokale map met de onderstaande opdracht:
    cd [uw repository]
    Voer bijvoorbeeld in:
    cd /volume1/mysharefolder/myrepo1