Uw projecten beheren met versiebeheer

U kunt versiebeheer gebruiken om de ontwikkeling van een gegevensproject te beheren en wijzigingen bij te houden.

Als u met versiebeheer werkt, kunt u tijdens het ontwerpen versies van de projecten vastleggen. Hiermee kunt u wijzigingen tussen twee versies van het project bekijken. U kunt uw gegevensprojecten ook ontwikkelen met behulp van een vertakkingsstrategie. Hierdoor kunt u in elk werkgebied of vertakking aan een geïsoleerde versie van het project werken. Het werkgebied kan door meerdere gebruikers worden gedeeld. U kunt dan uw wijzigingen van het werkgebied samenvoegen in een hoofdvertakking om deze naar productie te implementeren.

GitHub wordt gebruikt als provider voor versiebeheer.

Aan de slag

• Maak een gebruiker aan in GitHub die de tenant kan gebruiken om GitHub te openen. Dit kan al voor u zijn aangemaakt door een beheerder.

  De gebruiker moet de volgende bereiken hebben:

  • repo

  • read:org

  • read:user

  • read:project

• U hebt schrijftoegang nodig in de opslagplaatsen die u wilt wijzigen.

• U moet een GitHub persoonlijk toegangstoken (classic) aanmaken. Aangepaste persoonlijke toegangstokens worden niet ondersteund.

  Voor meer informatie raadpleegt u de GitHub-documentatie: Uw persoonlijke toegangstokens beheren.

• Organisatie is verplicht in de GitHub-configuratie.

• U hebt de rol Kan bewerken nodig in de ruimte waarin het project zich bevindt om versiebeheeracties uit te voeren.

• Voordat u versiebeheer kunt gaan gebruiken, moet u een configuratie instellen om verbinding te maken met GitHub met de GitHub-gebruiker die u aangemaakt hebt.

  Configuratie naar GitHub instellen

• Als u een verbinding met GitHub hebt ingesteld, kunt u een project aan een opslagplaats koppelen.

  Een project verbinden met een opslagplaats

Configuratie naar GitHub instellen

Alle gebruikers die met versiebeheer willen werken, moeten een configuratie instellen om verbinding te maken met GitHub met behulp van een GitHub-gebruikersaccount.

U kunt GitHub configureren in Projecten. Zorg ervoor dat u zich hebt voorbereid volgens Aan de slag.

1. Klik op en dan op GitHub-configuratie.

2. Stel authenticatie in met uw organisatie en het GitHub persoonlijke toegangstoken, zoals beschreven in Aan de slag.

3. Klik op OK.

U kunt nu uw projecten verbinden met een opslagplaats.

Een project verbinden met een opslagplaats

U moet een project verbinden met een opslagplaats voordat u versiebeheer kunt gaan gebruiken. Zorg ervoor dat u een verbinding met GitHub hebt ingesteld.

1. Klik in Projecten op ... van een project en selecteer Verbinden met versiebeheer.

2. Selecteer met welke opslagplaats u het project wilt koppelen.

3. Voeg een pad voor de basismap toe.

   Als u verbinding wilt maken met een bestaand project in Github, moet u hetzelfde pad gebruiken.

4. U kunt ervoor kiezen om het project te bevestigen en het project na verbinding naar de externe opslagplaats te pushen. Voer een bevestigingsbericht in.

   As u niet nu bevestigt en pusht, wordt een hoofdvertakking gemaakt in het werkgebied, maar niet in de externe opslagplaats.

5. Klik op Verbinden.

Het project is nu verbonden met de geselecteerde opslagplaats. Dit wordt onderaan de projectkaart aangegeven met , de naam van de opslagplaats, en de huidige vertakking.

Wanneer u het project opent, zal de titelrij nu een GitHub-menu met versiebeheeropties bevatten. De projectnaam zal ook worden uitgebreid met de naam van de huidige vertakking.

Een project ontwikkelen met versiebeheer

U kunt versiebeheer op verschillende manieren gebruiken:

• Direct werken aan de hoofdvertakking. Dit is voornamelijk geschikt voor een enkele ontwikkelaar van een project die wijzigingen wil bijhouden, maar kan ook gebruikt worden door een groep ontwikkelaars die synchroon werken.

• Werken met een vertakkingsstrategie, waarbij meerdere ontwikkelaars kunnen bijdragen. U kunt ook vertakkingen aanmaken om nieuwe functies of wijzigingen van elkaar te isoleren.

Vereenvoudigde workflow voor project met één ontwikkelaar

U kunt direct aan de hoofdvertakking van een project werken. Deze aanpak is eenvoudiger en bevat minder bewerkingen, maar u kunt nog steeds wijzigingen bijhouden. Als er meerdere ontwikkelaars zijn, moeten ze goed op elkaar afgestemd zijn.

Wanneer u wijzigingen hebt aangebracht in het project dat u wilt toepassen, hoeft u alleen maar de bewerking Doorvoeren en pushen uit te voeren.

Workflow voor een project met meerdere ontwikkelaars

Deze workflow kan gebruikt worden als er meer dan één ontwikkelaar aan een project werkt, of als u wijzigingen wilt isoleren. Dit houdt in dat u een ontwikkelingsvertakking aanmaakt die u met andere gebruikers kunt delen. Met deze workflow kunnen de ontwikkelaars elkaars wijzigingen bijhouden en beslissen wanneer ze de wijzigingen samenvoegen naar de hoofdvertakking.

1. Een nieuwe vertakking maken

   Maak een nieuwe ontwikkelingsvertakking aan vanuit de hoofdvertakking. U kunt de vertakking met meer gebruikers delen.

2. Ontwikkelen

   Breng alle vereiste wijzigingen in het project aan.

   InformatieDatabaseschema's en verbindingen worden niet onderhouden in versiebeheer.

3. Externe wijzigingen toepassen

   Pas externe wijzigingen van een andere vertakking toe op uw werkgebied om er zeker van te zijn dat u up-to-date bent met wijzigingen van de andere vertakking. Dit is handig om conflicterende wijzigingen te vermijden of te beperken.

   Als u twee vertakkingen hebt die wijzigingen bevatten die conflicterend kunnen zijn, dan kunt u dit oplossen door het volgende te doen:

   1. Breng wijzigingen aan in beide werkgebieden.

   2. Voeg beide vertakkingen samen in de hoofdvertakking.

   3. Pas de externe wijzigingen nogmaals toe.

4. Doorvoeren en pushen

   Nu moet u uw wijzigingen doorvoeren en pushen naar de ontwikkelingsvertakking. Alle objecten worden gepusht, dus het is een goed idee om uw project te valideren voordat u ze doorvoert.

5. Een pullaanvraag openen en samenvoegen

   Als u klaar bent met ontwikkelen, is het tijd om de wijzigingen van het werkgebied samen te voegen naar de hoofdvertakking. Het samenvoegen van een ontwikkelingsvertakking naar de hoofdvertakking moet uitgevoerd worden in GitHub door een pullaanvraag te openen. U kunt goedkeuring instellen voor de vertakking die samengevoegd moet worden naar de hoofdvertakking. Voor meer informatie, zie GitHub-documentie voor pullaanvragen

Een nieuwe vertakking maken

1. Klik in Projecten op ... van een project en selecteer Nieuwe vertakking maken.

   Het project moet zijn verbonden met versiebeheer.

2. Selecteer om een vertakking te maken op basis van de hoofdvertakking.

3. Voer een naam in voor de vertakking.

4. Stel een prefix in dat wordt toegevoegd aan alle schema's in het project in Vertakkingsprefix voor alle schema's. Hierdoor kunnen alle schema's een unieke naam krijgen om naamgevingsconflicten te voorkomen.

5. Klik op Maken.

Er wordt een nieuwe vertakking van de hoofdvertakking gemaakt en uitgecheckt uit de opslagplaats. De vertakking bevat een nieuwe versie van het project, met alle taken in de status Nieuw. Dat wil zeggen: ze zijn niet voorbereid en bevatten geen gegevens.

Externe wijzigingen toepassen

U kunt wijzigingen vanuit de externe opslagplaats toepassen op uw werkgebied. Dit kunnen wijzigingen zijn die buiten het geïntegreerde versiebeheer van Qlik Cloud zijn gemaakt, bijvoorbeeld in GitHub of door andere tools. Dit helpt u om conflicten te vermijden wanneer u uw wijzigingen wilt doorvoeren en naar de vertakking wilt pushen.

1. Klik in Projecten op ... van een project en selecteer Externe wijzigingen toepassen.

   Het venster Externe wijzigingen toepassen op werkgebied wordt weergegeven als er wijzigingen zijn gevonden.

2. U kunt nu selecteren voor welke taken u wijzigingen wilt toepassen en de wijzigingen inspecteren. Voor elke wijziging kunt u selecteren welke versie u wilt gebruiken, de externe versie of de versie in uw werkgebied.

3. Klik op Externe wijzigingen toepassen.

U moet bronverbindingen en doelverbindingen toevoegen als de wijzigingen nieuwe gegevenstaken omvatten.

Doorvoeren en pushen

U kunt uw wijzigingen doorvoeren en pushen naar de vertakking. Aangezien externe wijzigingen die niet op uw werkgebied zijn toegepast, overschreven kunnen worden, moet u de optie Externe wijzigingen toepassen uitvoeren voordat u ze doorvoert en pusht.

1. Klik in Projecten op ... van een project en selecteer Doorvoeren en pushen.

   Het dialoogvenster Doorvoeren en pushen wordt weergegeven als er wijzigingen zijn gevonden.

2. Voeg een doorvoerbericht toe dat u kan helpen om bij te houden wat er veranderd is.

3. Klik op Doorvoeren en pushen

Een vertakking verwijderen

U kunt een vertakking verwijderen als u uw wijzigingen naar de hoofdvertakking heeft samengevoegd.

1. Klik in Projecten op ... van de vertakking die u wilt verwijderen en selecteer Vertakking verwijderen.

   U kunt er ook voor kiezen om de externe vertakking in versiebeheer te verwijderen.

   Als er niet-doorgevoerde wijzigingen zijn, dan zult u moeten bevestigen dat deze wijzigingen verloren gaan bij het verwijderen van de vertakking.

Versiebeheer voor een project verwijderen

U kunt uw project ontkoppelen van versiebeheer. Als er bestaande vertakkingen zijn, moeten deze verwijderd worden voordat u het project kunt ontkoppelen.

1. Klik in Projecten op ... van het project dat u wilt ontkoppelen en selecteer Ontkoppelen van GitHub.

Een project delen met andere ruimten of tenants

U kunt een versie van een project delen met een andere ruimte in dezelfde tenant of in een andere tenant. Dit is handig als u twee omgevingen wilt maken, bijvoorbeeld één voor ontwikkeling en één voor productie.

1. Maak een nieuw project met dezelfde naam als het oorspronkelijke project.

   Stel hetzelfde gebruiksscenario en hetzelfde platformtype in. U kunt verschillende verbindingen gebruiken.

2. Verbind het nieuwe project met dezelfde opslagplaats en hetzelfde pad van de basismap als het oorspronkelijke project.

   InformatieSelecteer de optie Doorvoeren en pushen niet.

3. Als de verbinding van het platform naar hetzelfde doel wijst als het oorspronkelijke project, zorg er dan voor dat u de database of schema's van de gegevenstaken wijzigt. Een manier om de schema's van alle taken te wijzigen is door Prefix voor alle schema's te wijzigen in Metagegevens projectinstellingen voordat u externe wijzigingen toepast. Dit zorgt ervoor dat alle taken met dit prefix worden aangemaakt.

4. Pas externe wijzigingen toe en selecteer alle bestanden.

5. Voeg ontbrekende bronverbindingen toe voor alle tussenopslagtaken.

   Klik op Gegevensbron selecteren in de tussenopslagtaak, selecteer de verbinding en klik op Opslaan.

   InformatieDe verbinding moet van hetzelfde type bron zijn en verwijzen naar tabellen met dezelfde namen als in het oorspronkelijke project.

6. Voeg ontbrekende bron- en doelverbindingen toe voor alle replicatietaken.

Hierdoor wordt een ander werkgebied gemaakt. U kunt wijzigingen in het project aanbrengen in een van de werkgebieden en Externe wijzigingen toepassen gebruiken om het andere werkgebied te synchroniseren.

Beveiligingsoverwegingen

Zorg ervoor dat u gesynchroniseerde beveiligingsconfiguraties tussen Qlik Talend Data Integration en GitHub onderhoudt.

• In Qlik Talend Data Integration zijn machtigingen gebaseerd op ruimten die meerdere projecten kunnen bevatten. In GitHub zijn machtigingen gebaseerd op opslagplaatsen die ook meerdere projecten kunnen bevatten. Het beste is om ze op elkaar af te stemmen en alle projecten in één ruimte te verbinden met dezelfde opslagplaats.

• Houd in gedachten dat Qlik Talend Data Integration en GitHub gebruikmaken van verschillende machtigingen en rollen voor gebruikers.

Aanbevolen procedures

Hier volgen enkele aanbevolen procedures voor het werken met projecten met versiebeheer.

• Voeg een README-bestand toe dat de opslagplaats in GitHub beschrijft. Voor meer informatie raadpleegt u Over README's.

• Voer alleen projecten door die geldig en getest zijn om uit te voeren.

  Als u projecten toevoegt met tussenopslag- of geregistreerde gegevenstaken die nog niet zijn voorbereid of getransformeerd, worden de bronkolommen nog niet opgenomen. Bronkolommen worden toegevoegd wanneer de taak wordt voorbereid en getransformeerd.

• Wanneer u een vertakking aanmaakt voor replicatieprojecten, moet u zich ervan bewust zijn dat de vertakkingen standaard hetzelfde doel gebruiken. Dit betekent dat lopende taken in de vertakking gegevens van de hoofdversie kunnen overschrijven. Om gegevensverlies te voorkomen, wijzigt u de doelinstellingen in de vertakking zodat deze niet conflicteren met de hoofdversie.

• Wanneer u een vertakking aanmaakt, kunnen er externe wijzigingen zijn die nog niet zijn toegepast op het werkgebied. Pas externe wijzigingen toe voor of na het aanmaken van de vertakking, tenzij u de externe wijzigingen wilt verwijderen.

• Wijzigingen aanbrengen aan dezelfde gegevensverzameling in twee verschillende vertakkingen kan resulteren in samenvoegconflicten die moeilijk op te lossen zijn.

Beperkingen

• Het is niet mogelijk om een project los te koppelen of te verwijderen met behulp van versiebeheer als er vertakkingen zijn. De vertakkingen moeten worden verwijderd voordat u het project kunt ontkoppelen of verwijderen.

• Het is niet mogelijk om een project met versiebeheer een andere naam te geven.

• Als u een tenant verwijdert, zullen objecten die zijn opgeslagen met versiebeheer in GitHub niet verwijderd worden. U moet deze objecten handmatig verwijderen.

• Als een opslagplaats door veel projecten wordt gebruikt, of veel bestanden bevat die niet in Qlik Talend Data Integration worden opgeslagen, kunnen de prestaties afnemen.

• Databaseschema's en verbindingen worden niet onderhouden in versiebeheer.

• Aangepaste persoonlijke toegangstokens van GitHub worden niet ondersteund.

• Een vertakking (behalve de hoofdvertakking) kan maar door één project per opslagplaats gebruikt worden, zelfs als er twee projecten in dezelfde opslagplaats zijn.

• Het is niet mogelijk om externe wijzigingen toe te passen vanuit een project dat een ander doelplatform gebruikt. Als u bijvoorbeeld wijzigingen in een project in Snowflake vastlegt, kunt u de wijzigingen niet toepassen op een Databricks-project.