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 zjistí změna velikosti 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, aby byly vybrané soubory sledovány z hlediska změn.

    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) seskupuje všechny soubory z jednoho exportu do jednoho potvrzení (commit) a jednoho požadavku na stažení (pull request), takže CI běží jednou na export bez ohledu na počet souborů.

    Soubory jsou seskupeny do jednoho potvrzení, pokud mají veškerý obsah 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 potvrzen samostatně, nikoli seskupen.

    Zprávy o potvrzení jsou generovány automaticky a nelze je přizpůsobit. Při exportu jako požadavek na stažení lze název požadavku na stažení a název cílové větve přizpůsobit.

    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í.

    Migrace na nový konektor GitHub (Beta)

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

    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žka).

    • 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 App.

      1. V 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ěnit Typ na GitHub (Beta).

      5. Klikněte na Připojit.

        Phrase přesměruje na GitHub za účelem autorizace aplikace Phrase GitHub App.

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

        GitHub automaticky přesměruje na Phrase.

      7. Vybrat uživatele nebo organizaci uživatelský účet, ke kterému se chcete připojit.

    2. vytvořit nový konektor.

      1. V 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. Vybrat instalaci aplikace GitHub App nastavenou v první fáze.

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

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

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

        • Regex pro filtrovat souborů (pokud je nakonfigurován)

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

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

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

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

      Zatím neodstraňovat ani nezakázat stávající APC.

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

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

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

    4. Ověřte pomocí testovacího stáhnout.

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

      2. Spusťte stáhnout prostřednictvím nového konektor.

      3. Potvrdit:

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

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

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

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

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

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

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

      3. Monitorujte jeden nebo dva cykly stáhnout před vyřazením starší konektor z provozu.

    6. Vyřadit z provozu starší konektor.

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

      1. odstranit staré APC.

      2. odstranit starší konektor z nastavení → Konektory → GitHub (starší).

      3. Volitelně zrušte platnost token OAuth pro uživatelský účet, který byl používán starší konektor.

    nastavení GitHub (starší)}} {"translations":{"translation_1":"Zakázat APC na starším konektoru.","translation_2":"Povolit APC na novém konektoru (odebrat režim dry-run).","translation_3":"Monitorujte jeden nebo dva cykly stáhnout před vyřazením starší konektor z provozu.","translation_4":"Vyřadit z provozu starší konektor.","translation_5":"Po potvrzení, že je nový konektor stabilní:","translation_6":"odstranit staré APC.","translation_7":"odstranit starší konektor z nastavení → Konektory → GitHub (starší).","translation_8":"Volitelně zrušte platnost token OAuth pro uživatelský účet, který byl používán starší konektor.","translation_9":"nastavení GitHub (starší)","translation_10":"Nejsou vyžadovány žádné změny.","translation_11":"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.","translation_12":"Po uložení lze ke konektoru přistupovat přes Vlastní doménu.","translation_13":"Změnit Typ na GitHub a zadejte název pro konektor.","translation_14":"Volitelně Vybrat Stáhnout překlady jako pull requesty a zadejte Větev pull requestu.","translation_15":"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:","translation_16":"Kliknutím na odkaz otevřete oficiální stránku konektoru Phrase App v nové záložka: https://github.com/apps/phrase-app-connector-eu (datové centrum EU) nebo https://github.com/apps/phrase-app-connector-us (datové centrum US).","translation_17":"Nainstalujte aplikaci Phrase GitHub do cílového uživatelský účet GitHub.","translation_18":"Pokud aplikace GitHub není nainstalována v cílovém uživatelský účet GitHub uživatel, konektor GitHub uvidí pouze veřejná úložiště.","translation_19":"Dokončit instalační proceduru výběrem všech soukromých úložišť, která budou viditelná a přístupná pro konektor GitHub.","translation_20":"Vraťte se na stránku Phrase Konektory/vytvořit pro autorizaci aplikace GitHub a připojení k GitHub."}}}

    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ěnit Typ na GitHub a zadejte název pro konektor.

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

    6. 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 App v nové záložka: 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ý účet GitHub.

        Poznámka

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

      3. Dokončit instalační proceduru výběrem všech soukromých úložišť, která budou viditelná a přístupná pro konektor GitHub.

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

    7. 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.

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

    9. 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 zobrazí malé zaškrtnutí.

    10. 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, není možné po uložení nastavení konektoru 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.