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

    • Plány Team, Business a Enterprise

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

    K dispozici pro

    • Plány 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 stahování zdrojových souborů a nahrávání cílových souborů přímo do/z úložiště GitHub.

    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. Ověření úč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.

    ověřování

    Konektor GitHub (Beta) používá GitHub App installation token 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 ověřování pomocí GitHub App. Možnost OAuth z původního konektoru není podporována.

    Exportovat

    Konektor GitHub (Beta) seskupuje všechny soubory z jednoho exportu do jednoho potvrzení (commit) a jednoho požadavku na sloučení (pull request), takže CI proběhne jednou na export bez ohledu na počet souborů.

    Soubory jsou seskupeny do jednoho commitu, pokud všechny položky pocházejí od stejného vlastníka, ze stejného úložiště a ze stejné větve.

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

    Zprávy o potvrzení se generují automaticky a nelze je přizpůsobit. Při exportu jako pull request lze název pull requestu a název cílové větve přizpůsobit.

    Známá omezení

    • Konektor umí pouze vypisovat, stahovat a nahrávat soubory. Mazání nebo přesouvání souborů v GitHubu není podporováno. Jakékoli mazání nebo přejmenování musí být provedeno přímo v GitHubu.

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

    • 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 instalaci GitHub App, 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 ní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řepínání konektorů v průběhu projektu očekávejte, že počet slov a spotřeba MTU/kreditů u dotčených souborů bude odrážet úplný opětovný import.

    Předpoklady:

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

    • Instalace GitHub App musí mít přístup k úložištím s obsahem k překladu, jinak import prostřednictvím APC selže.

    • Stávající nastavení APC jsou viditelná (ponechte starý konektor otevřený na druhé kartě).

    • 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 pro autorizaci aplikace Phrase GitHub App.

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

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

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

    2. Vytvořte 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 App nastavenou v prvním kroku.

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

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

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

        • Regex filtru 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 stejné instalace aplikace GitHub App je možné vytvořit více konektorů, každý s nezávislým nastavením.

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

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

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

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

      3. Zkontrolujte spárované soubory. Potvrďte, že rozsah odpovídá tomu, co sleduje stávající 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. Potvrdit

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

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

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

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

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

      1. Deaktivujte APC na starším konektoru.

      2. Aktivujte APC na novém konektoru (odstraňte režim simulace).

      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 (starší).

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

    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ěření 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ě povolte Použít vlastní doménu a zadejte URL rozhraní API.

    6. Volitelně vyberte Exportovat překlady jako žádosti o sloučení a zadejte Větev žádosti o sloučení.

    7. V případě potřeby vyberte Použít aplikaci GitHub pro zobrazení URL aplikace Phrase GitHub a import/export souborů pomocí autorizačního toku 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 GitHub do cílového účtu 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 postup instalace výběrem libovolných soukromých úložišť, která budou pro konektor GitHub viditelná a přístupná.

      4. Vraťte se na stránku Connectors/Create ve Phrase, autorizujte aplikaci GitHub a připojte se k GitHubu.

    8. Klikněte na Connect to GitHub. 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 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/karta zmizí a vedle tlačítka Connect to GitHub se objeví malá značka 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, 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.