Hoppa till huvudinnehåll

GitHub-integration

Översikt över GitHub-integrationen​

SEW har för närvarande stöd för integration med GitHub, vilket gör att du kan koppla ditt GitHub-konto och dina repositorier direkt till plattformen. Genom denna anslutning kan GitHub fungera som ett lokalt, versionshanterat repositorium som hålls synkroniserat med SEW-repositoriet. Administratörer kan konfigurera autentisering, välja repositorier och hantera synkroniseringsinställningar – vilket gör det möjligt för team att behålla välbekanta GitHub-arbetsflöden samtidigt som de drar nytta av SEW:s centraliserade projekthantering och automatiseringsfunktioner.

Viktiga funktioner i integrationen​

Att integrera GitHub med SEW ger flera fördelar:

  • Effektiviserat arbetsflöde: Integrerar sömlöst GitHubs robusta versionshantering med SEW:s versionshantering av PLC-projekt och PLC-hanteringsfunktioner, vilket förbättrar samarbetet i teamet.
  • Centraliserad hantering: Kombinera kodrepositorier och PLC-projekthantering i en enda plattform för att förenkla administration och åtkomstkontroll.
  • Automatisering och driftsättning: Använd SEW:s pipelines för automatiserade driftsättningsfunktioner för att effektivisera projektsläpp direkt från GitHub-repositorier.
  • Samarbete i realtid: Uppdateringar och ändringar synkroniseras omedelbart, vilket säkerställer att alla teammedlemmar arbetar med den senaste projektversionen.

Genom att integrera GitHub med SEW kan ditt team öka produktiviteten och projekteffektiviteten.

Så här ansluter du SEW till GitHub​

Konfigurera GitHub för SEW-integration​

  1. Logga in på GitHub: Se till att du har dina GitHub-inloggningsuppgifter redo.
  2. Generera personlig åtkomsttoken: För att ge SEW åtkomst, gå till Developer settings, välj Personal access tokens och skapa en ny Fine-grained token. Ange behörigheterna Contents och Metadata för de repositorier du vill dela.
  3. Kopiera token: Förvara din token säkert, eftersom den kommer att användas under autentiseringsprocessen i SEW.

Genom att följa dessa förberedande steg är ditt GitHub-konto redo för integration med SEW, vilket gör att du kan dra nytta av förbättrat samarbete och projekthantering.

Ansluta din GitHub till ditt SEW-konto​

Följ dessa steg för att ansluta din SEW-plattform till GitHub:

  1. Öppna inställningar: Navigera till SEW-plattformen och gå till avsnittet "General Settings".
  2. Skapa en ny integration: Gå till avsnittet Integrations och lägg till en ny integration genom att klicka på Add Integration.
  3. Autentisera GitHub-kontot: I fönstret Add Integration anger du integrationens namn och klistrar in din GitHub-åtkomsttoken.

Konfigurera webhooks för automatiska uppdateringar​

För att aktivera automatiska uppdateringar och säkerställa att SEW omgående informeras om ändringar behöver du konfigurera webhooks i dina GitHub-repositorier. Så här konfigurerar du denna funktion:

  1. Öppna repositoriets inställningar:

    • Börja med att navigera till ditt GitHub-repositorium.
    • Klicka på fliken "Settings", som vanligtvis finns längst till höger i repositoriets navigeringsfält.

  2. Hitta avsnittet Webhooks:

    • När du är i inställningarna, bläddra nedåt eller leta efter alternativet "Webhooks" i menyn till vänster.
    • Klicka på "Webhooks" för att hantera och lägga till nya hooks.

  3. Skapa en ny webhook:

    • Tryck på knappen "Add webhook" för att påbörja konfigurationen av en ny webhook.
    • Du uppmanas att ange en Payload URL, vilket är den slutpunkt dit du vill skicka HTTP POST-förfrågningar när vissa händelser inträffar. Du kan kopiera detta värde från din nyskapade integration.

  4. Konfigurera webhookens payload:

    • Under "Content type" väljer du application/json för att säkerställa att du får data i ett strukturerat format.
    • Ställ in den hemliga nyckeln för att skydda din webhook mot obehörig åtkomst. Du kan kopiera detta värde från din SEW-integration.

  5. Välj händelser:

    • Välj alternativet "Just push events".

  6. Slutför konfigurationen:

    • Kontrollera konfigurationerna en extra gång.
    • Klicka på "Add webhook" för att slutföra och aktivera webhooken.

När konfigurationen är klar kommer din webhook att skicka uppdateringar till SEW.

Länka ett repositorium till ett SEW-projekt​

Följ dessa steg för att länka ett repositorium till ett SEW-projekt:

  1. Öppna projektavsnittet: Öppna ditt SEW-projekt.

  2. Öppna projektets redigeringsmeny: Välj de tre punkterna i det övre högra hörnet på projektsidan.

  3. Anslut repositorium:

    • Välj "Link to Repository".
    • Välj ett repositorium från listan att länka.

  4. Bekräftelse: Kontrollera att konfigurationen fungerar. Om den lyckades visas en GitHub-ikon i projektinformationens rubrik.

Förbereda ditt repositorium för SEW-integration​

Nu när ditt repositorium är konfigurerat och anslutet ska du förbereda dess innehåll så att SEW förstår hur det ska hanteras.

Mappstruktur för GitHub-repositoriet​

SEW-integrationsprocessen kräver att varje repositorium innehåller ett enda PLC-projekt. Även om mappstrukturen kan anpassas av användaren måste rotmappen innehålla en config.sda.json-fil. Denna fil anger leverantör och IDE-version för PLC-projektet.

Schema för konfigurationsfilen

  • schema_version: Anger versionen av konfigurationsfilens schema. Standardvärdet är 1.0.0, vilket möjliggör framtida förbättringar och bibehåller bakåtkompatibilitet.
  • vendor: Anger PLC-projektets leverantör. Godkända värden är:
    • siemens
    • rockwell
  • ide_version: Anger PLC-projektets version. Den följer formatet {major}.{minor}.{patch}. Till exempel motsvarar Siemens TIA V17 17.0.0 och Rockwell V37 representeras som 37.0.0.
  • project_path: Detta fält anger den korrekta sökvägen till PLC-projektet i ditt repositorium. Det använder ett relativt sökvägsformat som utgår från repositoriets rotmapp. Det innebär att du inte ska inkludera själva rotkatalogen i sökvägen när du anger project_path. Ange i stället de sökvägssegment som leder till den specifika PLC-projektmappen. Om ditt PLC-projekt till exempel ligger i en mapp med namnet Projects som finns direkt i rotkatalogen, och det inuti Projects finns en PLC1-mapp där de önskade projektfilerna förvaras, skulle din project_path vara ./Projects/PLC1/MySiemensPLCProject.zap17. Denna uppsättning bidrar till konsekventa filreferenser i olika miljöer där repositoriet kan användas, eftersom den inte förlitar sig på absoluta sökvägar som kan variera mellan system.
    • Siemens PLC-projekt: För hantering av Siemens PLC-projekt erbjuder vi stöd för både den komprimerade .zap-filen och den okomprimerade mappstrukturen som innehåller .ap-filer. Så här kan du arbeta med dessa format:
      • Komprimerad fil: Om du har ditt projekt i komprimerat format kan du använda .zap-filen direkt. Detta är användbart för att enkelt överföra projekt som ett enda paket. Använd till exempel filsökvägen:
        • ./Projects/PLC1/MySiemensPLCProject.zap17
        • ./MySiemensPLCProject.zap19
      • Okomprimerad mapp: Alternativt kan du arbeta med en okomprimerad mapp som innehåller .ap-filerna. Denna uppsättning ger enklare åtkomst till enskilda projektkomponenter, vilket kan vara fördelaktigt under utveckling eller felsökning. Använd följande sökväg för att komma åt ditt projekt:
        • ./Projects/PLC1/MySiemensPLCProject/MySiemensPLCProject.ap17
        • ./MySiemensPLCProject/MySiemensPLCProject.ap19
    • Rockwell PLC-projekt: För Rockwell PLC-projekt är processen förenklad. Dessa projekt är samlade i en enda .ACD-fil, vilket förenklar projekthantering och delning. Följ dessa steg för att komma åt ditt Rockwell PLC-projekt:
      • ACD-fil: .ACD-filen omfattar alla nödvändiga projektdata. Peka helt enkelt på filen:
        • ./Projects/PLC1/MyRockwellPLCProject.ACD
        • ./MyRockwellPLCProject.ACD

Exempel på en config.sda.json-fil​

{
    "schema_version": "1.0.0",
    "vendor": "siemens",
    "ide_version": "17.0.0",
    "project_path": "./SimulatedAxisSinamicsV90_S71212C.zap17"
}

När processen har slutförts kommer ditt repositorium att vara länkat till SEW-projektet, vilket underlättar bättre samarbete och projekthantering. Från och med nu kommer varje ny commit som pushas till ditt GitHub-repositorium att skapa en motsvarande projektversion i ditt SEW-projekt.