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

    • Edice Team, Business a Enterprise

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

    K dispozici pro

    • Edice Ultimate a Enterprise (starší)

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

    Tip

    Informace o integraci GitHub v Phrase Strings naleznete v GitHub (Strings).

    Konektor GitHub umožňuje stahování zdrojových souborů a nahrávání cílových souborů přímo do/z úložiště GitHub.

    Konektor využívá API GitHub k implementaci integrace. Konektor umožňuje přístup ke všem úložištím přidruženým k uživatelskému účtu GitHub. Ověřování uživatelského účtu GitHub lze provést také v aplikaci GitHub.

    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 změní velikost souboru.

      • Tento konektor podporuje nastavení absolutní cesty. Cílové překladové soubory lze uložit pouze do stejné větve, jako je zdrojový soubor.

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

    GitHub (Beta)

    Poznámka

    Konektor je od června 2026 ve fázi beta.

    Ověřování

    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 nadále funguje.

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

    Export

    Konektor GitHub (Beta) dávkuje všechny soubory z jednoho stažení do jednoho commitu a jednoho pull requestu, takže CI běží jednou na stažení bez ohledu na počet souborů.

    Soubory jsou dávkovány do jednoho commitu, pokud veškerý obsah sdílí stejného vlastníka úložiště, úložiště a větev.

    Pokud je APC nakonfigurováno tak, aby nahrávalo soubory ihned po jejich individuálním dokončení, bude každý soubor commitován samostatně, nikoli dávkově.

    Zprávy commitů jsou generovány automaticky a nelze je přizpůsobit. Při stahování jako pull request lze přizpůsobit název pull requestu a název cílové větve.

    Známá omezení

    • Konektor umí pouze vypsat seznam, stáhnout a nahrát soubory. Mazání nebo přesouvání souborů v GitHub není podporováno. Jakékoli mazání nebo přejmenování musí být provedeno přímo v GitHub.

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

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

    • Nový konektor nepodporuje tok 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řepnutí průběžného APC ze staršího konektoru na nový konektor není migrace. Phrase s tím zachází jako s novou konfigurací konektoru, takže APC znovu importuje zdrojový soubor jako novou zakázku namísto aktualizace té stávající. Soubor je považován za nový obsah, takže dříve zpracovaná slova a jednotky strojového překladu (MTU) se nepřenášejí. Při přepínání konektorů v průběhu projektu počítejte s tím, že počet slov a spotřeba MTU u dotčených souborů budou odrážet úplný opětovný import.

    Předpoklady:

    • Přístup správce k vaší organizaci GitHub pro instalaci aplikace GitHub. Nainstalujte ji na úrovni organizace, aby pokrývala všechna úložiště, která vaše APC monitorují.

    • Stávající nastavení APC jsou viditelná (ponechte starý konektor otevřený v druhé záložce).

    • Testovací větev nebo neprodukční úložiště pro ověření před přepnutím živých pracovních postupů.

    Postupujte podle těchto kroků:

    1. Nainstalujte aplikaci Phrase GitHub.

      1. Ve Phrase TMS 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 (Beta).

      5. Klikněte na Připojit.

        Phrase vás přesměruje na GitHub, abyste autorizovali aplikaci Phrase GitHub.

      6. Na GitHubu vyberte organizaci nebo uživatelský účet a úložiště, ke kterým chcete udělit přístup, a poté potvrďte instalaci. Zahrňte každé úložiště, které je aktuálně monitorováno stávajícím konektorem (konektory).

        GitHub vás automaticky přesměruje zpět do Phrase.

      7. Vyberte uživatele nebo organizaci, ke které se chcete připojit.

    2. Vytvořit nový konektor.

      1. Ve Phrase TMS na stránce nastavení Setup_gear.png přejděte dolů do oddílu Integrace.

      2. Klikněte na Konektory.

      3. Klikněte na Nový konektor.

      4. Vyberte instalaci aplikace GitHub nastavenou v první fázi.

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

        • Úložiště a větev

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

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

        • Režim stažení: 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)

        Je možné vytvořit více konektorů pod stejnou instalací aplikace GitHub, každý s nezávislým nastavením.

    3. Znovu vytvořte stávající APC pomocí režimu dry-run.

      Zatím neodstraňujte ani nezakazujte stávající APC.

      1. Vytvořte nové APC směřující na nový konektor, které budou zrcadlit stávající konfiguraci APC.

      2. Povolte režim dry-run u každého nového APC před jeho aktivací. Režim dry-run prohledá úložiště a spáruje soubory, aniž by spustil překladové úlohy.

      3. Zkontrolujte spárované soubory. Potvrdit, že rozsah odpovídá tomu, co monitoruje stávající APC.

    4. Ověřte pomocí testovacího stažení.

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

      2. Spusťte stažení prostřednictvím nového konektoru.

      3. Potvrdit:

        • Vytvoří se jeden commit (nikoliv jeden na soubor).

        • Commit se zobrazí pod identitou aplikace GitHub, nikoli pod osobním uživatelským účtem.

        • CI se spustí jednou, nikoli jednou pro každý soubor.

    5. Přepněte živé pracovní postupy.

      Jakmile ověření proběhne:

      1. Zakázat APC na starším konektoru.

      2. Povolit APC na novém konektoru (odebrat režim dry-run).

      3. Před vyřazením staršího konektoru monitorujte jeden nebo dva cykly stáhnout.

    6. Vyřadit starší konektor.

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

      1. Odstraňte staré APC.

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

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

    Nastavení GitHub (starší)

    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 použili ověřování vyžadované pro vytvoření nebo uložení konektoru. Po uložení lze ke konektoru přistupovat přes Vlastní doménu.

    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ě Povolit Použít Vlastní doménu a zadejte API URL.

    6. Volitelně Vybrat Stáhnout překlady jako pull requesty a zadejte Větev pull requestu.

    7. V případě potřeby Vybrat Použít aplikaci Github pro zobrazení URL aplikace Phrase GitHub a import/stáhnout souborů pomocí autorizačního toku aplikace GitHub:

      1. Kliknutím na odkaz otevřete oficiální stránku konektoru Phrase v nové záložce: https://github.com/apps/phrase-app-connector-eu (datové centrum EU) nebo https://github.com/apps/phrase-app-connector-us (datové centrum US).

      2. Nainstalujte aplikaci Phrase GitHub do cílového uživatelského účtu GitHub.

        Poznámka

        Pokud aplikace GitHub není nainstalována v cílovém uživatelském účtu GitHub uživatele, konektor GitHub uvidí pouze veřejné repozitáře.

      3. Dokončete postup instalace výběrem všech soukromých repozitářů, které budou viditelné a přístupné pro konektor GitHub.

      4. Vraťte se na stránku Phrase Connectors/Create pro autorizaci aplikace GitHub a připojení k GitHub.

    8. Klikněte na Connect to GitHub. Pokud nejste připojeni pomocí aplikace GitHub, zobrazí se vyskakovací okno nebo nová záložka s žádostí o autorizaci.

    9. V případě potřeby zadejte Commit message.

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

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

      Pokud je operace úspěšná, okno/záložka zmizí a vedle tlačítka Connect to GitHub se objeví malé 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é změnit metodu autorizace.

    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.