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

    Pro informace o integraci GitHubu v Phrase Strings se odkažte na 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 používá API GitHubu k implementaci integrace. Konektor umožňuje přístup ke všem úložištím spojeným s uživatelským účtem GitHub. Ověřování uživatelského účtu GitHub lze také provést v GitHub App.

    Případy 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 mohou být uloženy pouze ve stejné větvi jako zdrojový soubor.

    • Nastavte nepřetržité úlohy, aby byly vybrané soubory sledovány na změny.

    GitHub (Beta)

    Poznámka

    Konektor je v beta verzi od června 2026.

    Ověřování

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

    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 commitu a jednoho pull requestu, takže CI běží jednou na export bez ohledu na počet souborů.

    Soubory jsou seskupeny do jednoho commitu, když všechny obsahy sdílejí stejného vlastníka úložiště, úložiště a větev.

    Pokud je APC nakonfigurováno pro nahrávání souborů, jakmile jsou jednotlivě dokončeny, každý soubor bude commitován samostatně místo seskupení.

    Zprávy o commitech jsou generovány automaticky a nelze je přizpůsobit. Pokud se exportuje jako pull request, název pull requestu a název cílové větve lze přizpůsobit.

    Známá omezení

    • Konektor může pouze vylistovat, stáhnout a nahrát 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.

    • Vylistování souborů nemusí správně fungovat pro úložiště s více než 50 000 soubory kvůli omezením API GitHubu.

    • GitHub Enterprise Server v současnosti není podporován.

    • Nový konektor nepodporuje OAuth tok ze staršího konektoru. Pokud má vaše organizace omezení na instalaci GitHub aplikací, vyřešte je před migrací.

    Migrace na nový GitHub (Beta) konektor

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

    Předpoklady:

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

    • Existující nastavení APC viditelná (nechte 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 toků.

    Postupujte podle těchto kroků:

    1. Nainstalujte aplikaci Phrase GitHub.

      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ěňte Typ na GitHub (Beta).

      5. Klikněte na Připojit.

        Phrase přesměruje na GitHub pro autorizaci aplikace Phrase GitHub.

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

        GitHub automaticky přesměrovává na Phrase.

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

    2. Vytvořte 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. Vyberte instalaci GitHub App nastavenou v první fázi.

      5. Zkopírujte nastavení z existujícího konektoru:

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

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

        • Regex pro filtraci souborů (pokud je nakonfigurováno)

        • 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)

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

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

      Zatím neodstraňujte ani nezakazujte existující APC.

      1. Vytvořte nové APC směřující na nový konektor, které zrcadlí konfiguraci existujících APC.

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

      3. Zkontrolujte shodné soubory. Potvrďte, že rozsah odpovídá tomu, co existující APC sleduje.

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

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

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

      3. Potvrdit:

        • Byl vytvořen jediný commit (ne jeden na soubor).

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

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

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

      Jakmile validace projde:

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

      2. Povolit APC na novém konektoru (odebrat režim suchého běhu).

      3. Sledujte jeden nebo dva exportní cykly před vyřazením staršího konektoru.

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

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

      1. Odstranit staré APC.

      2. Odstranit starší konektor z Nastavení → Konektory → GitHub (starší).

      3. Volitelně, odvolat OAuth token pro uživatelský účet, který byl použit starším konektorem.

    Nastavení GitHubu (starší)

    Žádné změny nejsou vyžadovány.

    Nastavení Phrase TMS

    Důležité

    Pokud přistupujete z vlastní domény (např. mydomain.phrase.jp), otevřete okno inkognito a přihlaste se přes cloud.memsource.com nebo us.cloud.memsource.com, abyste použili ověřování potřebné pro vytvoření nebo uložení konektoru. Po uložení je možné přistupovat k konektoru 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 pro konektor.

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

    6. Pokud je to nutné, vyberte Použít aplikaci Github, abyste zobrazili URL adresu aplikace Phrase GitHub a importovali/exportovali soubory pomocí autorizačního procesu aplikace GitHub:

      1. Klikněte na odkaz pro otevření oficiální stránky Konektoru aplikace Phrase v novém panelu: https://github.com/apps/phrase-app-connector-eu (EU datové centrum) nebo https://github.com/apps/phrase-app-connector-us (US datové centrum).

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

        Poznámka

        Pokud není aplikace GitHub nainstalována do cílového uživatelského účtu, budou konektoru GitHub viditelné pouze veřejné repozitáře.

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

      4. Vraťte se na stránku Phrase Connectors/Create, abyste autorizovali aplikaci GitHub a připojili se k GitHubu.

    7. Klikněte na Připojit k GitHubu. Pokud nejste připojeni pomocí aplikace GitHub, objeví se vyskakovací okno nebo nový panel, který požaduje autorizaci.

    8. Pokud je to nutné, zadejte Zprávu o commitu.

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

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

      Pokud je to úspěšné, okno/panel zmizí a vedle tlačítka Připojit k GitHubu se objeví malá fajfka.

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