Integrace
    1. Phrase
    2. Phrase TMS
    3. Integrace

    GitHub (TMS)

    Obsah je strojově přeložen z angličtiny s použitím Phrase Language AI.

    K dispozici pro

    • Tarify Team, Business a Enterprise

    S dotazy ohledně licencí se obraťte na prodejce.

    K dispozici pro

    • Tarify Ultimate a Enterprise (starší verze)

    S dotazy ohledně licencí se obraťte na prodejce.

    Tip

    Informace o integraci GitHub v Phrase Strings naleznete v části GitHub (Strings).

    Konektor GitHub umožňuje stahovat zdrojové soubory přímo z úložiště GitHub a nahrávat do něj cílové soubory.

    Konektor využívá k implementaci integrace rozhraní GitHub API. Konektor umožňuje přístup ke všem úložištím přidruženým k účtu GitHub. Autentizaci účtu GitHub lze provést také v GitHub App.

    Příklady použití

    Konektor lze použít v několika případech:

    • Projektoví manažeři mohou přidat soubory přímo do projektů z online úložiště.

    • Nastavte portál zadavatele tak, aby zadavatelé mohli přidat soubory k požadavkům přímo z online úložiště.

    • Použijte automatizované vytváření projektů (APC) k automatickému vytváření nových projektů, jakmile se u sledovaných souborů nebo složky zjistí změna velikosti souboru.

      • Tento konektor podporuje nastavení absolutní cesty. Cílové překladové soubory lze ukládat pouze do stejné větve jako zdrojový soubor.

    • Nastavte průběžné úlohy pro sledování změn u vybraných souborů.

    GitHub (Beta)

    Poznámka

    Konektor je od června 2026 ve verzi beta.

    Autentizace

    Konektor GitHub (Beta) používá instalační token aplikace GitHub namísto individuálního uživatelského účtu. Tokeny mají krátkou platnost a obnovují se automaticky. Pokud uživatel opustí organizaci nebo ztratí přístup k úložišti, konektor bude nadále fungovat.

    Konektor GitHub (Beta) podporuje pouze autentizaci pomocí aplikace GitHub. Možnost OAuth z původního konektoru není podporována.

    Export

    Konektor GitHub (Beta) seskupuje všechny soubory z jednoho exportu do jednoho commitu a jednoho pull requestu, takže se CI spustí pouze jednou při každém exportu bez ohledu na počet souborů.

    Soubory se seskupí do jednoho commitu, pokud mají veškerý obsah společného vlastníka úložiště, úložiště a větev.

    Pokud je APC nakonfigurováno tak, aby soubory nahrávalo jednotlivě po dokončení, bude každý soubor zahrnut do samostatného commitu, nikoli do společného.

    Zprávy ke commitům se generují automaticky a nelze je přizpůsobit. Při exportu formou pull requestu lze upravit název pull requestu a název cílové větve.

    Cesta exportu a podsložky

    Když cesta pro export souborů online úložiště začíná / (absolutní cesta), konektor GitHub (Beta) zachová strukturu podsložek zdrojových souborů. Každý přeložený soubor se exportuje do stejné podsložky pod cestou exportu, v jaké je zdrojový soubor ve složce sledované automatickým vytvářením projektů (APC).

    Soubor umístěný přímo ve sledované složce se exportuje přímo do umístění určeného cestou exportu. Pro relativní cestu exportu nebo v případě, že nejsou zahrnuty podsložky, se nepřidává žádná podsložka.

    Absolutní cesta exportu začíná v kořenovém adresáři úložiště zdrojové větve.

    Známá omezení

    • Konektor umí pouze vypisovat, stahovat a nahrávat soubory. Mazání nebo přesouvání souborů v GitHubu není podporováno. Soubory je nutné mazat nebo přejmenovávat přímo na GitHubu.

    • Výpis souborů nemusí fungovat správně u úložišť s více než 50 000 soubory kvůli omezením rozhraní API GitHubu.

    • GitHub Enterprise Server není v současné době podporován.

    • Nový konektor nepodporuje postup ověřování OAuth ze staršího konektoru. Pokud má vaše organizace omezení pro instalace aplikací GitHub, vyřešte je před migrací.

    Přechod na nový konektor GitHub (Beta)

    Automatizovaná migrace není možná kvůli změně modelu ověřování.

    Poznámka

    Přechod z průběžného APC používajícího starší konektor na nový konektor není migrací. Phrase s tím zachází jako s novou konfigurací konektoru, takže APC znovu importuje zdrojový soubor jako novou úlohu namísto aktualizace té stávající. Se souborem se zachází jako s novým obsahem, takže dříve zpracovaná slova a jednotky strojového překladu (MTU) se nepřenášejí. Při přepnutí konektorů v průběhu projektu počítejte s tím, že počet slov a spotřeba MTU/kreditů u dotčených souborů budou odpovídat úplnému opětovnému importu.

    Předpoklady:

    • Přístup správce k vaší organizaci GitHub pro instalaci aplikace GitHub. Nainstalujte ji na úrovni organizace, aby pokrývala všechny repozitáře, které vaše APC monitorují.

    • Instalace aplikace GitHub musí mít přístup k repozitářům s obsahem k překladu, jinak import prostřednictvím APC selže.

    • Mějte k dispozici stávající nastavení APC (starý konektor ponechte otevřený na druhé kartě).

    • Testovací větev nebo neprodukční repozitář pro ověření před přepnutím živých pracovních postupů.

    Postupujte podle těchto kroků:

    1. Nainstalujte aplikaci Phrase GitHub App.

      1. Na stránce Nastavení Setup_gear.png v systému Phrase TMS přejděte dolů do oddílu Integrace.

      2. Klikněte na Konektory.

        Otevře se stránka Konektory.

      3. Klikněte na Nový konektor.

        Otevře se stránka Vytvořit konektor.

      4. Změňte Typ na GitHub (Beta).

      5. Klikněte na Připojit.

        Systém Phrase vás přesměruje na GitHub za účelem autorizace aplikace Phrase GitHub App.

      6. Na GitHubu vyberte organizaci nebo účet a repozitáře, ke kterým chcete udělit přístup, a poté instalaci potvrďte. Zahrňte všechny repozitáře, které stávající konektor či konektory aktuálně monitorují.

        GitHub vás automaticky přesměruje na Phrase.

      7. Vyberte uživatelský nebo organizační účet, který chcete připojit.

    2. Vytvořte nový konektor.

      1. Na stránce Nastavení Setup_gear.png v systému Phrase TMS přejděte dolů do oddílu Integrace.

      2. Klikněte na Konektory.

      3. Klikněte na Nový konektor.

      4. Vyberte instalaci aplikace Phrase GitHub App nastavenou v prvním kroku.

      5. Zkopírujte nastavení ze stávajícího konektoru:

        • Repozitář a větev

        • Cesta k podsložce (pokud používáte monitorování podsložek)

        • Regulární výraz pro filtr souborů (pokud je nakonfigurován)

        • Režim exportu: přímý commit nebo pull request a cílová větev

        • Název pull requestu a název cílové větve (pokud používáte režim PR)

        V rámci jedné instalace aplikace Phrase GitHub App lze vytvořit více konektorů, každý s vlastním nastavením.

    3. Znovu vytvořte stávající APC v režimu zkušebního spuštění.

      Zatím stávající APC nemažte ani nevypínejte.

      1. Vytvořte nová APC propojená s novým konektorem se stejným nastavením, jaké mají stávající APC.

      2. Před aktivací každého nového APC u něj povolte režim zkušebního spuštění. Režim zkušebního spuštění prohledá úložiště a vyhledá odpovídající soubory, aniž by spustil překladové úlohy.

      3. Zkontrolujte nalezené soubory. Ověřte, že rozsah odpovídá souborům sledovaným stávajícím APC.

    4. Ověřte pomocí testovacího exportu.

      1. Proveďte malou změnu v souboru ve sledovaném rozsahu.

      2. Spusťte export prostřednictvím nového konektoru.

      3. Ověřte:

        • Vytvoří se jeden commit (nikoli samostatný commit pro každý soubor).

        • Commit se zobrazí pod identitou aplikace GitHub App, nikoli pod osobním účtem.

        • CI se spustí jednou, nikoli jednou na soubor.

    5. Přepněte pracovní postupy v ostrém provozu.

      Jakmile ověření proběhne úspěšně:

      1. Zakažte APC u staršího konektoru.

      2. Povolte APC u nového konektoru (odstraňte režim dry-run).

      3. Před vyřazením staršího konektoru z provozu monitorujte jeden nebo dva cykly exportu.

    6. Vyřaďte starší konektor z provozu.

      Po potvrzení, že je nový konektor stabilní:

      1. Odstraňte staré APC.

      2. Odstraňte starší konektor v Nastavení → Konektory → GitHub (Legacy).

      3. Volitelně zrušte platnost OAuth tokenu pro uživatelský účet, který používal starší konektor.

    Nastavení GitHubu (starší verze)

    Nejsou vyžadovány žádné změny.

    Nastavení Phrase TMS

    Důležité

    Pokud přistupujete z vlastní domény (např. mydomain.phrase.jp), otevřete okno prohlížeče v režimu inkognito a přihlaste se přes cloud.memsource.com nebo us.cloud.memsource.com, abyste provedli ověření potřebné k vytvoření nebo uložení konektoru. Po uložení lze ke konektoru přistupovat prostřednictvím vlastní domény.

    1. Na stránce Nastavení Setup_gear.png přejděte dolů do oddílu Integrace.

    2. Klikněte na Konektory.

      Otevře se stránka Konektory.

    3. Klikněte na Nový konektor.

      Otevře se stránka Vytvořit konektor.

    4. Změňte Typ na GitHub a zadejte název konektoru.

    5. Volitelně povolte Použít vlastní doménu a zadejte URL adresu API.

    6. Volitelně vyberte Exportovat překlady jako pull requesty a zadejte Větev pull requestu.

    7. V případě potřeby vyberte Použít aplikaci GitHub. Zobrazí se adresa URL aplikace Phrase pro GitHub a budete moci importovat a exportovat soubory pomocí autorizačního procesu aplikace GitHub:

      1. Kliknutím na odkaz otevřete oficiální stránku Phrase App Connector na nové kartě: https://github.com/apps/phrase-app-connector-eu (datové centrum EU) nebo https://github.com/apps/phrase-app-connector-us (datové centrum USA).

      2. Nainstalujte aplikaci Phrase pro GitHub na cílový účet GitHub.

        Poznámka

        Pokud aplikace GitHub není nainstalována v cílovém účtu GitHub uživatele, konektor GitHub uvidí pouze veřejná úložiště.

      3. Dokončete instalaci výběrem soukromých úložišť, ke kterým bude mít konektor GitHub přístup a která pro něj budou viditelná.

      4. Vraťte se na stránku Konektory/Vytvořit v aplikaci Phrase, autorizujte aplikaci GitHub a připojte se ke službě GitHub.

    8. Klikněte na Připojit ke GitHubu. Pokud nejste připojeni pomocí aplikace GitHub, zobrazí se vyskakovací okno nebo nová karta s žádostí o autorizaci.

    9. V případě potřeby zadejte Zprávu commitu.

    10. Klikněte na tlačítko Autorizovat Phrase.

      Pokud používáte aplikaci GitHub, klikněte na tlačítko Autorizovat Phrase App Connector.

      Pokud je operace úspěšná, okno nebo karta zmizí a vedle tlačítka Připojit ke GitHubu se objeví malá ikona zaškrtnutí.

    11. Klikněte na Uložit.

      Konektor je přidán do seznamu na stránce Konektory.

      Důležité

      Pokud je konektor GitHub vytvořen pomocí autorizačního toku aplikace GitHub, po uložení nastavení konektoru již není možné metodu autorizace změnit.

    Byl pro vás tento článek užitečný?
    ★ ★ ★ ★ ★

    Sorry about that! In what way was it not helpful?

    The article didn’t address my problem.
    I couldn’t understand the article.
    The feature doesn’t do what I need.
    Other reason.

    Note that feedback is provided anonymously so we aren't able to reply to questions.
    If you'd like to ask a question, submit a request to our Support team.
    Thank you for your feedback.